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MCS Overview 

What is MCS 

Multics Communications System 

Software to transfer data to/from terminals or other devices connected via 
communications lines 

Sometimes called MCM: Multics Communications Manager 

Design is generalized, table -driven 

Especially good at supporting diverse asynchronous terminals 

In this course most of the major MCS topics are covered 

I Administration 

I CMF, TTF, FNP images 

I Use 

I All Ring interfaces to MCS functions 

I Internals 

I Ring and FNP 

I Metering and Debugging 

I Ring and FNP 

I There are certain topics within MCS or related to MCS that will not be 
covered in detail 

I Details of various protocols 

1 HASP, X.25, etc. 

I Video System 

I I/O Daemon software 

I FNPs other than 355/6670 families 

J}NB 
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h Standard Communications Concepts 

Some communications concepts that are not necessarily specific to Multics need 
to be understood in order to understand MCS. 

I ASCII Character Set 

I Multics was one of the first systems to use ASCII standard 

I Character sizes 

I 128 7 -bit characters defined by standard 

I Usually transmitted as 8 -bit characters 

I 7 data bits plus 1 parity bit 

I Stored in 9 -bit bytes in Multics 

I 7 data bits plus 2 zero bits 
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7 -bit Character 

6 5 4 3 2 1 



D|D|D|D|D|D|D 
a|a|a|a|a|a|a 
t|tjt|t|t|tjt 
a|aja|aja|a|a 



7 -bit Character Plus Parity Bit 
87654321 
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a 
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a 
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7 -bit Character Stored in 9 -bit Byte 



I |D|D|D|D|D|D|D 

I |a|a|a]a|a|a[a 

0|0|t|t|t|tjt|t|t 

I |a|a|a|a|a|a|a 



I Control characters 

I Some ASCII codes are non-printing and have special uses 
I Multiple names are sometimes confusing 

I X-OFF, DC3, Control-S, A S, \023 

I X-ON, DC1, Control -Q, A Q, \021 
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I ESC, Control- [, A [, \033 
I LF, NL, Control-J, A J, \012 
I CR, Control -M, A M, \015 
I BS, Control -H, A H, \010 
J Formfeed, NP, Control -L, A L, \014 
I PAD, DEL, Rubout, \177 

I NUL, Control-®, A @, Control-SP, A SP, \000 
I BREAK (QUIT) Is not an ASCII character 

I BREAK is a line condition discussed later under RS232 
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ASCII Character Set Chart 











Multics 






Bin 


Oct 


Dec 


Hex 


Def. 


Key /Name 


Other Definitions 


0000000 


000 





00 


NUL 


Control-@ 


Control -SP on some terminals 


0000001 


001 


1 


01 




Control -A 


SOH, Start of Header 


0000010 


002 


2 


02 




Control -B 


STX, Start of Text 


0000011 


003 


3 


03 




Control -C 


ETX, End of Text 


0000100 


004 


4 


04 




Control-D 


EOT, End of Transmission 


0000101 


005 


5 


05 




Control -E 


ENQ, Enquiry 


0000110 


006 


6 


06 




Control -F 


ACK , Acknowledge 


0000111 


007 


7 


07 


BEL 


Control -G 


Bell 


0001000 


010 


8 


08 


BS 


Control -H 


Backspace 


0001001 


Oil 


9 


09 


HT 


Control -I 


Horizontal Tab 


0001010 


012 


10 


OA 


NL 


Control -J 


Newline, Line Feed, LF 


0001011 


013 


11 


OB 


VT 


Control -K 


Vertical Tab 


0001100 


014 


12 


OC 


NP 


Control -L 


New Page, Form Feed, FF 


0001101 


015 


13 


OD 


CR 


Control -M 


Carriage Return 


0001110 


016 


14 


OE 


RRS 


Control -N 


Red Ribbon Shift, SO, Shift Out 


0001111 


017 


15 


OF 


BRS 


Control -O 


Black Ribbon Shift, SI, Shift In 


0010000 


020 


16 


10 




Control -P 


DLE, Data Link Escape 


0010001 


021 


17 


11 




Control -Q 


DC1, X-ON 


0010010 


022 


18 


12 




Control -R 


DC2 


0010011 


023 


19 


13 




Control -S 


DCS, X-OFF 


0010100 


024 


20 


14 




Control -T 


DC4 


0010101 


025 


21 


15 




Control -U 


NAK, Negative Acknowledge 


0010110 


026 


22 


16 




Control -V 


SYN , Synchronous Idle 


0010111 


027 


23 


17 




Control -W 


ETB, End of Transmission Block 


0011000 


030 


24 


18 




Control -X 


CAN, Cancel 


0011001 


031 


25 


19 




Control -Y 


EM, End of Medium 


0011010 


032 


26 


1A 




Control -Z 


SUB 


0011011 


033 


27 


IB 




ESC, Control- [ 


Escape, Alt -mode 


0011100 


034 


28 


1C 




Control -\ 


FS, File Separator 


0011101 


035 


29 


ID 




Control-] 


GS , Group Separator 


0011110 


036 


30 


IE 




Control- A 


RS , Record Separator 


0011111 


037 


31 


IF 




Control -_ 


US , Unit Separator 


0100000 


040 


32 


20 


SP 


blank 


Space 


0100001 


041 


33 


21 


f 


exclamation point 


0100010 


042 


34 


22 


IT 


double quote 




0100011 


35 


35 


23 


# 


number sign 




0100100 


044 


36 


24 


$ 


dollar sign 




0100101 


045 


37 


25 


% 


percent 




0100110 


046 


38 


26 


& 


ampersand 




0100111 


047 


39 


27 


r 


o/infa o /*» /-» g-rrf- 




0101000 


050 


40 


28 


( 


left parenthesis 


0101001 


051 


41 


29 


) 


right parenthes 


is 


0101010 


052 


42 


2A 


* 


asterisk 




0101011 


053 


43 


2B 


+ 


plus 




0101100 


054 


44 


2C 


) 


comma 




0101101 


055 


45 


2D 


- 


minus 




0101110 


056 


46 


2E 


. 


period 




0101111 


057 


47 


2F 


/ 


right slash 
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0110000 


060 


48 


30 










0110001 


061 


49 


31 


1 


1 




0110010 


062 


50 


32 


2 


2 




0110011 


063 


51 


33 


3 


3 




0110100 


064 


52 


.y-T 




4 




0110101 


065 


53 


35 


5 


5 




0110110 


066 


54 


36 


6 


6 




0110111 


067 


55 


37 


7 


7 




0111000 


070 


56 


38 


8 


8 




0111001 


071 


57 


39 


9 


9 




0111010 


072 


58 


3A 


I 


colon 




0111011 


073 


59 


3B 


* 


semicolon 


0111100 


074 


60 


3C 


< 


less than 


0111101 


075 


61 


3D 


= 


equals 




0111110 


076 


62 


3E 


> 


greater 


than 


0111111 


077 


63 


3F 


? 


question mark 


1000000 


100 


64 


40 


k 


commercial at 


1000001 


101 


65 


41 


A 


Capital 


A 


1000010 


102 


66 


42 


B 


Capital 


B 


1000011 


103 


67 


43 


C 


Capital 


C 


1000100 


104 


68 


44 


D 


Capital 


D 


1000101 


105 


69 


45 


E 


Capital 


E 


1000110 


106 


70 


46 


F 


Capital 


F 


1000111 


107 


71 


47 


G 


Capital 


G 


1001000 


110 


72 


48 


H 


Capital 


H 


1001001 


111 


73 


49 


I 


Capital 


I 


1001010 


112 


74 


4A 


J 


Capital 


J 


1001011 


113 


75 


4B 


K 


Capital 


K 


1001100 


114 


76 


4G 


L 


Capital 


L 


1001101 


115 


77 


4D 


M 


Capital 


M 


1001110 


116 


78 


4E 


N 


Capital 


N 


1001111 


117 


79 


4F 





Capital 





1010000 


120 


80 


50 


P 


Capital 


P 


1010001 


121 


81 


51 


Q 


Capital Q 


1010010 


122 


82 


52 


R 


Capital 


R 


1010011 


123 


83 


53 


S 


Capital 


S 


1010100 


124 


84 


54 


T 


Capital 


T 


1010101 


125 


85 


55 


U 


Capital 


U 


1010110 


126 


86 


56 


V 


Capital 


V 


1010111 


127 


87 


57 


w 


Capital 


w 


1011000 


130 


88 


58 


X 


Capital 


X 


1011001 


131 


89 


59 


Y 


Capital 


Y 


1011010 


132 


90 


5A 


Z 


Capital 


z 


1011011 


133 


91 


5B 


[ 


left bracket 


1011100 


134 


92 


5C 


\ 


back slash 


1011101 


135 


93 


5D 


] 


right bracket 


1011110 


136 


94 


5E 


A 


circumflex 


1011111 


137 


95 


5F 




underline 


1100000 


140 


96 


60 


% 


grave accent 


1100001 


141 


97 


61 


a 


small a 




1100010 


142 


98 


62 


b 


small b 




1100011 


143 


99 


63 


c 


small c 




1100100 


144 


100 


64 


d 


small d 




1100101 


145 


101 


65 


e 


small e 
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1100110 


146 


102 


66 


f 


small 


f 


1100111 


147 


103 


67 


g 


small 


g 


1101000 


150 


104 


68 


h 


small 


h 


1101001 


151 


105 


69 


i 


small 


i 


1101010 


152 


106 


6A 


J 


small 


J 


1101011 


153 


107 


6B 


k 


small 


k 


1101100 


154 


108 


6G 


1 


small 


1 


1101101 


155 


109 


6D 


m 


small 


m 


1101110 


156 


110 


6E 


n 


small 


n 


1101111 


157 


111 


6F 


o 


small 


o 


1110000 


160 


112 


70 


P 


small 


P 


1110001 


161 


113 


71 


q 


small 


q 


1110010 


162 


114 


72 


r 


small 


r 


1110011 


163 


115 


73 


s 


small 


s 


1110100 


164 


116 


74 


t 


small 


t 


1110101 


165 


117 


75 


u 


small 


u 


1110110 


166 


118 


76 


V 


small 


V 


1110111 


167 


119 


77 


w 


small 


w 


1111000 


170 


120 


78 


X 


small 


X 


1111001 


171 


121 


79 


y 


small 


y 


1111010 


172 


122 


7A 


z 


small 


z 


1111011 


173 


123 


7B 


{ 


left brace 


1111100 


174 


124 


7C 


1 


vertical bar 


1111101 


175 


125 


7D 


} 


right 


brace 


1111110 


176 


126 


7E 


~ 


tilde 




1111111 


177 


127 


7F 


PAD 


DEL 





Rubout 
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I Baud Rate 

I Discrete signal events transmitted per second 

{ Usually but not always equal to bits per second (bps) 

I New 2400 bps modems are 1200 baud 

J Line protocol 

I Parameters of a line that user can't change 

I Parameters that user can change are called terminal protocol 

I A line can have several levels of protocols that: 

I Synchronise data transmission and reception 

I Ensure correct and complete .reception of data by flow control 
and acknowlegement of received data. 

I Multiplex data for different devices on single line 
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Communications Protocols Supported by Multics 



SERIAL BINARY 



ASYNCHRONOUS 



SYNCHRONOUS 



/ 

| Synchronisation 
| of Clocks 
i and Data 

\ 



! I I 

KERMIT XMODEM BISYNC 



I 

I 

HDLC 

I 
I 
I 
I 
I I I I 
I I I I I 
3270 HASP 2780 3780 X.25 



I 



I 






G115 



/ 

| Reliability 
| of data (flow 
j control & 
| acknowledge) 

\ 



I / 
RCI VIP POLLED | Multiplexing 






6 I 



VIP 



\ 






/JS 
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I Asynchronous Protocols 

I Data comes in bit by bit as changing signal on a wire with one 
voltage to represent logic and another to represent logic 1 

I Two things need to be synchronized between the sender and the 
receiver: 

j When to sample each bit (synchronising clocks) 

I Which bit is the first in data (first in each character) 

I Asynchronous protocols resynchronize both for each character 

J Start bit used to signal beginning of first bit of character 

I Transition from idle state (logic 1) to start bit (logic 0) 

I One or two stop bits used to put line in idle state at end of 
each character 

I 10 bits used to send 1 character, so BPS - 10 CPS, efficiency 
70% 
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Asynchronous Protocol 
Problem: Synchronisation of clocks and of data start 

"6" = 066 octal = 0110110 binary = 00110110 with even parity 
At 300 baud, 1/300 sends between bits. 



Bits sent to send ASCII "6" 

> Message Flow > 

P | D6 | D5 | D4 | D3 | D2 | Dl 
110 11 



DO 














— — — 


AAAAAAAA 


| 1 


1 


1 


1 | 1 


1 


1 1 


| 300 


300 


300 


300 j 300 


300 


300 1 



P D6 D5 D4 D3 D2 Dl DO 
Sanroline needed everv 1/300 second to read received bits. 
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Asnynchronous Protocol 



Idle 



Bits sent to send ASCII "6" 

> Message Flow - - - -> 

| Stop | P 1 D6 | D5 | D4 | D3 | D2 
1 1 1 



Dl | DO |Strt| Idle 
1 



1 1 


1 


1 


1 


1 


1 


1 | 


| 300 


300 


300 


300 


300 


300 


300 1 



D6 D5 D4 D3 D2 Dl DO 



3 I 

... , 

600 | 

I 
See 

Transition 
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Asynchronous throughput 



• • • 




... 


" 







" 




... 





...1 110 





1 


1 


01100100 


1 


1 





1 


10 11 


I I S P 


D 


D 


D 


DDDDSSPD 


D 


D 


D 


D 


D D S I I 


d d t a 


a 


a 


a 


aaaattaa 


a 


a 


a 


a 


a a t d d 


1 1 o r 


t 


t 


t 


ttttaort 


t 


t 


t 


t 


t t a 1 1 


e e p i 


a 


a 


a 


aaaarp ia 


a 


a 


a 


a 


a a r e e 


t 








t t 










t 


y 








y 

1 parity bit 
1 start bit 
1 stop bit 












7 data bits 








3 overhead bits 











Maximum throughput: 70% 
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1 In Multics, maximum speed for asynchronous lines is 19,200 bps 
I Protocol used by typical asynchronous terminals is called ASCII 

I Could be used by non- ASCII, e.g. EBCDIC, terminals 
I Multics used to support other asynchronous protocols 

1 2741 

I 1050 

I ARDS 

I Standard asynchronous connections provide no guarantee of reliability 

I The Kermit and XMODEM protocols sit on top of the asynchronous 
protocol 

I They provide flow control, error detection, acknowledgement, for 
the purposes of reliable file transfer 

I Synchronous Protocols 

I Again, need to synchronize clocks and data 

I Clocks are synchronized by extra signal 

I Data synchronization is per -block 

I Two or more SYNCcharacters are sent to indicate start of block 

I Typical synchronous protocol adds information at beginning and end of 
each block 

I Block length, checksum, etc. 

I Typical synchronous protocol requires acknowledgement of each block 
from receiver 

I Throughput depends on details of protocol, but is higher than 
asynchronous for medium to high volumes of data 
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Typical Synchronous Protocol 



Idle 



1 s 


S 


H. 


.H 


D | 


1 Y 


Y 


D. 


.D 


A | 


1 N 


N 


R. 


.R 


T | 
A | 



D. 
A. 
T. 

A. 



.D 
.A 
.T 
.A 



! D 


T. . 


.T | 


1 A 


R. . 


.R | 


1 T 


A. . 


.A | 


1 A 


I. . 


.1 | 




L.. 


.L | 




E.. 


.E | 




R. . 


.R | 



Idle 



<-Sync-> <-Hdr-> < Data- > <-Trl-> 



Typical 
Values : 



2 100 

2 Sync bytes 
2 Header bytes 
2 Trailer bytes 



100 data bytes 8 Overhead bytes 
Throughput: 100/108 = 93% 
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I In Multics, maximum speed for a cynchroneu s lines is 72 KB 

I Multics supports a variety of synchronous protocols: 

i BSC 

J HASP 

I 2780/3780 

I 3270 

I G115 

I VIP 

I Polled VIP 

I HDLC 

J X.25 

I Multiplexer 

I There are many ways to have several logical connections over a single 
physical connection 

I This is known as a multiplexed line 

I For some types of multiplexed lines MCS can perform the work of 
multiplexing/demultiplexing the logical connections 

I The idea of multiplexing is generalized in MCS to include an 
arbitrary number of levels of multiplexing 

I MCS considers the FNP to be a multiplexer because it has many 

channels connected to it and multiplexes all of that information over 
a single physical connection (the DIA) 

1 Modem 

I MOdulator/DEModulator 

I Allows data to be transmitted over phone lines 

I Many different standards for modems 

I Modems may be full or half duplex 

J Not to be confused with echoplex 
I RS232/V24 
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I Defines connection between 

I Data Terminal Equipment (DTE) : Terminal or computer 
I Data Circuit- terminating Equipment (DCE) : Modems 

I Connection is by 25 pin connectors and cables 

I Diagram shows the pins used by Multics in asynchronous connections 

I Synchronous connection also uses pin 24 for timing (clock signal) 

I Used for all Multics protocols except HDLC 

J 

Pft 



£ 











J'. . 
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RS-232/V24 










Phone 




DTE RS232 
1 


DCE 


lines DCE 
i 


RS232 DTE 
1 


1 1 


v I 




1 v | 


1 V | | 


| Terminal | - • 
1 1 


■---I 
1 


Modem 


I T^-r^^-^w^. | Modem 
1 1 


| | Computer | 

1 1 1 


CCITT 










Circuit 










Pin No . 


Name 


Nom 


Description 


Description 


1 101 


GND 


TP 


Ground 


Terre de protection 


7 102 


GND 


TS 


Ground 


Terre de signalisation 


2 --> 103 


TX 


ED 


Transmission 


Emission de donnees 


3 <-= 104 


PvX 


RD 


Reception 


Reception des donnees 


H --> 105 


RTS 


DPE 


Request to send 


Demande pour emettre 


' 5 <-- 106 


CTS 


PAE 


Clear to send 


Pret a emettre 


6 <-- 107 


DSR 


PDP 


Dataset ready 


Poste de donne pret 


8 <-- 109 


CD 


DP 


Carrier Detect 


Detection de la porteuse 


20 --> 108 


DTR 


CPD 


Data terminal ready 


Connectez le poste de donnees 



MALE 



\ / 

\1 2 3 4 5 6 7 8 9 10 11 12 13/ 

\ / 

\ 14 15 16 17 18 19 20 21 22 23 24 25 / 

\ / 



FEMALE 



\ / 

\13 12 1110987654 3 2 1/ 

\ / 

\ 25 24 23 22 21 20 19 18 17 16 15 14 / 

\ / 
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Modem Dialup Sequence 

TTY Modem ======= Modem FNP 

DTE DGE DCE DTE 

g (TX) 2 > 2 2 < 2 (TX) f 

f (RX) 3 < 3 3 > 3 (RX) g 

c (RTS) 4 > 4 4 < 4 (RTS) b 

e (CTS) 5 < 5 5 > 5 (CTS) e 

d (DSR) 6 < 6 6 > 6 (DSR) a 

e (GD) 8 < 8 8 > 8 (CD) e 

c (DTR) 20 - > 20 20 <- -20 (DTR) b 



To listen to a line, the FNP raises RTS (pin 4) and DTR (pin 20) 
and then waits for CTS (pin 5) , DSR (pin 6) and CD (pin 8) to go 
high. 

The FNP detects a hangup if DSR (pin 6) or CD (pin 8) drop for more 
than one second. If CTS (pin 5) drops, the FNP suspends output. 

Scenario : 

a) Modem on FNP is powered on. ^'"i ®£ 1 

b) FNP boots and listens to the line. f«,!t/£ fiti lO")^ 

c} The tsrtnina 1 is f-iirne»d n n iT*.Vt»r *?, «T* 

d) The terminal's modem is turned on. ».»<'*»» Oi^, 

e) The telephone call is made and the modems are connected, f vfN [c^S C D\ 

f) Multics sends the login banner. J 

g) User types login line. 






n 
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I Break/Interrupt 

I Out-of-band signal 

J Logic on pin 2 for 100 to 600 msec 
I Line Driver 

I Also known as short-haul modems or point-to-point modems 

I Inexpensive replacement for modems for point-to-point connections 

I No real standards 
I Direct Connect 

I For very short distances, a direct RS232 connection is possible 

I Very inexpensive replacement for modems 

I Theoretically limited to about 50' 

I Practically can be extended much further 

I Known as hardwired connection, null modem, modem bypass 

I Each DTE must be made to think it is connected to a DCE 
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6 -WIRE DIRECT CONNECT 



TTY FNP 

DTE DTE 

(PG) 1 1 

(SG) 7 - 7 

(TX) 2 --\ / 2 

\ 
(RX) 3 / \ 3 

(RTS) 4 --| |-- 4 

I I 

(CTS) 5 --I I-- 5 

(DSR) 6 --| |-- 6 

i I 

<CD) 8 --| \ / |-- 8 

\ 
(DTR) 20 -/ \ 20 

5 -WIRE DIRECT CONNECT 



TTY FNP 

DTE DTE 

(PG) 1 1 

(SG) 7 7 

(TX) 2 \ / 2 

\ 
(EX) 3 - / \ 3 

(RTS) 4 --| |-- 4 

I I 

(CTS) 5 --| J-- 5 

(DSR) 6 --, .(-- 6 

I I 

(CD) 8 --|----\ / l-- 8 

\ 
(DTR) 20 / \ 20 
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Direct -Connect Dialup Sequence 







TTY 




FNP 










DTE 




DTE 






d 


(TX) 


2 ... 


---A /-- 

\ 


..... 2 


(TX) 


d 


c 


(RX) 


3 --- 


----/ V- 


..... 3 


(RX) 


c 


b 


(RTS) 


4 -| 
i 




I-- 4 
i 


(RTS) 


a 


b 


(CTS) 


i 
5 --] 




1 

j.. 5 


(CTS) 


a 


a 


(DSR) 


6 --, 
i 




1-- 6 
i 


(DSR) 


b 


a 


(CD) 


1 
8 -| 


\ 


1 
--I-- 8 


(CD) 


b 


b 


(DTR) 


20 --« 


----/ V- 


. 20 


(DTR) 


a 


Scenario : 















a) FNP boots and listens to the line. 

b) The terminal is turned on. 

c) Multics sends the login banner. 

d) User types login line. 



4-WIRE DIRECT CONNECT 
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|» 6 
1 


(CD) 

(DTR) 


8 — 

20 --■ 


/ 


1 

I-- 8 

20 



MCS Overview 



Standard Communications Concepts 



F86 Page 1-22 



I Line Monitor 

I Monitor RS232 signals and display transmitted and received data 
I Breakout Box 

I Monitor RS232 signals 

I Also known as a Blue Box. 

Line Monitors , Blue Boxes 



DTE RS232 

1 


DCE 


Phone 

lines 
1 

i v 

i 


DCE 


RS232 DTE 
1 


1 v i 

Terminal | -+ +- j 
III! 


Modem 


1 

| Modem 

1 


1 v | 

| -+ +- | Computer 

MM 


1 
1 


1 1 


•1 

J 




1 1 


| Blue Box/ 
| Line Mon, 

1 


| Blue Box/| 
| Line Mon. | 

1 1 
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h Standard Multics Concepts 

I Ring Supervisor 

I When a process requires supervisor services , it executes supervisor 
programs 

I Three ways to enter supervisor code: 

I Call 

I Explicit request for supervisor services 

I For example, create a segment, make a segment known, write 
data to a terminal, read input from a terminal, etc. 

I Fault 

I Faults are caused by conditions within the CPU 

I Implicit request for supervisor services 

I For example, page faults, segment faults, linkage faults 

I Interrupt 

I Interrupts are caused by conditions outside the CFU 

I Perform a service for another process 

I For example, handle completion of a disk read, interrupt 
from FNP, etc. 

I Initializer/Answering Service 

I The Initializer process has a number of tasks to perform 

J Listen to login lines 

I Execute operator commands 

I Load FNPs, other multiplexers 

I Etc. 
I Block/Wakeup 

I Mechanism used to wait for events of unknown duration 

I Terminal I/O, tape I/O 

I Process is in user ring while blocked 
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I When event occurs , some other process sends a wakeup to blocked 
process 

I Compare with Wait/Notify, to wait for events of short duration 

I Disk I/O, system locks 

I Process is in ring while waiting 

I When event occurs, some other process notifies waiting process 
by changing its Traffic Control state 
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a MCS Parts 

I FNP 
I Ring 
J Ring 4 
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MCS Parts 



Central 
System (CS) 

Multics 

Host 



Direct 

Interface 

Adapter 



355 



Communica- 
tion lines 

Communica- 
tion 
Devices 



RING 4 



- - - hcs 



RING 



DIA 



I/O Modules , e.g. tty_ 

Block/Wakeup 

PL/I: >sll, >sss 

Answering Service 
FNP loading, dumping 
PL/I: >tools 



Data conversion, translation 

Manage wired buffer space TTV^&oF 

Communicate with FNP 

Handle FNP interrupts 

De -multiplexing £n Jk r f sp?r>~><, 4»^ cr\ P"^ JsLff+6 

PL/I & ALM: Hardcore (MST) 



Dlccl v^-pr^c-e <\lo(PTqr 



FNP 



I I ! 

term mpx term 

/ \ 
term term 



Transfer of data over DIA <« 5 >"Wtf, p^7 

Buffer space management T )V_ © " P" 

Echoing 

Padding s*J.**> />ut s f*j> Jt/«rSj J*-* - # v *2<9 *" m ^ 

Flow control for ^yr/c X°" *ofiti 

Tell CS state of channels 



^PnH forminal ■T-nrvnf- i-r\ PC 

— irv 



Send output from CS to terminal 
Modem control (RS-232, e.g.) 
Interval timers 

Format, interpret synchronous msgs 
MAP355: loaded from Multics into FNP 
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I The Ring and FNP parts of MCS are covered in this course 

I The MCS functions made available to the user by Ring and the FNP 
will be explained using the tty_ I/O module as an example 

I Following diagram shows the relationships of the various I/O modules 
for terminal I/O 

I ttv _ uses the same hcs_ interface as other I/O modules, and therefore 
makes a good example 



I/O Module Dependencies 



+..... hasp_workstation_ <---- + 

I I 

+ hasp_host_ <----- + 

I I 

+ ibm3270_ I remote_input_ 

| +--ibm2780_/3780_ <--+ remote_punch_ 

+_„-__ bisync_ <----+ | remote_teleprinter_ 

hcs_ < + + -+ remote_printer_ 

+ gH5_ <---- + 

I I 

+ tty_ < + + 

I ~ I 

+ tc_io_ +_.___ kermit 

I I 

^ emacs + xmodem io 
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3 FNP Hardware Description 

I Up to 8 FNPs can be configured 
I Names 

FNP 

Front-End Network Processor 
Front End 
Fuh-Nup 
Datanet 
DN355 
355 
6670 
6678 
18x 
FEP 
MPX 
I Model Numbers 
I 355 

I The original Multics FNP 

I Has given its name to many of the MCS programs 
I Limited to 32K memory 
I No longer supported as of MRU 
I 6632 

I A newer version of the 355 
I Limited to 32K memory 
I No longer supported as of MRU 
I 6670 

I Level -6 based, emulates 355 
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I Up to 256K memory with extended memory addressing 
I Two models 

J 6678 with cache memory 
I 6651 without cache 
I Architecture 

I Has same basic architecture as Multics: IOM, SCU+MEM, GPU 
I Peripherals connected to IOM 
I DIA 
I HSLAs 

FNP Architecture 



+- 
I 
I 
I 

I 
+- 



CPU 



Multics 



+ 


+ + 


+ 


1 
1 
1 


---+ SCU +--■ 

|| MEM || 
1+ + 1 


• --+ 

1 
1 
1 


+ 


+ + 


+ 



IOM 



- + 
+- 



•DIA- 



FNP IOM Channels: 






FNP Console 


1 


FNP Reader 


2 


FNP printer 


3 




4 


DIA 


5 


e-pfh ty°i 


6 


HSLA 


7 


HSLA 1 


8 


HSLA 2 


9-14 


LSLAs O^ScW--*- 


15 


Clock 



FNP 

+ + +- + + + 

-+ IOM +--+ SCU +--+ CPU | 

I I I+---+I I I 
I I l|MEM|| | | 

I I l+-"+l I I 
+-+-+-+ + + + + 

I + + 

+.+ + +--+ + 

| HSLA | | HSLA | 



I I I 

I I I 



I I I 
I I I 



Terminals 
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I Data and Instruction Formats 
I 18 -bit words 
I I/O commands also know about 36 -bit words 
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STORE REFERENCE INSTRUCTION FORMAT 

1 

1_2_3 8_9 7 

111 I I 

III I I 

|I|TAG|Opcode| Delta | 



1 2 



INDEX REGISTER (Xn) -- UNPAGED ADDRESS 

1 
0_2_3 7 

1 I I 
| TAG | Address | 

I I. 



3 15 



INDEX REGISTER (Xn) -- PAGED ADDRESS 

1 1 

0_2_3 9_0 7 

II I I 

| TAG | Page No. | Offset | 

I I I ! 

3 7 8 
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ACCUMULATOR REGISTER (A) 

1 

7 

! I 

1 A I 

! I 

18 



QUOTIENT REGISTER (Q) 

1 

7 



18 



ACCUMULATOR-QUOTIENT REGISTER (AQ) 

11 3 

7_8 5 

II I 

| Even Word (A) | Odd Word (Q) | 



18 18 
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I Extended Memory Addressing 

J So-called paging is used to address beyond 32K 

J Difficult to program, so only certain types of data are stored ii 
extended memory 

I No programs in extended memory 




(K^ 



a- 



T^ 



5F-G 



JA^\ 



eUl^ ^O 5 ^ ^ 
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~)kls ' -«. *f\lfy ho^y </ i j Q^^ 



FNP Extended Memory Addressing 

+ 

I 
+ >+ 



Page Table 
+ --+ 

4000 | A-0+-- 
+ •-+ 

4001 | A-0+-- 
+ -+ 

4002 | A=0+-- 
+ + 

I • I 
I • I 
+ + 

4175 | A-0+-- 
+ + 

4176 | A-1+-- 
+ h 

hill | A-1+-- 
+ -+ 



+- 



I 
-+ 



-+ 

! 



Memory 



000000-000377 
Page 



+ - 

I 
->+ 

I 
+- 

I 
->+ 

I 
+- 



+ 



000400-000777 
Page 1 



001000-001377 
Page 2 



+ 



-x- 



076400-076777 
Page 175 



077000-077377 
Page 176 



| 077400-077777 
J Page 177, end of 32K 
+ — 



j 100000-100377 

j Page 200, start extended mem 



I 
->+ 100400-100777 
| Page 201 
+ 



I 



! 
+- 

I 
->+ 

I 
+- 

I 
I 
! 
+- 




177000-177377 
Page 376 



177400-177777 
Page 377, end of 64K 
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FNP Address Calculation Example 1 
Reference To Address In Low-Order Memory Using Non-Paged Addressing 

c (x2)= 076700; c<x3)=077240; c(475)=004000; c(4175)=000000; c(4176)=133040 




X- register 2 



1 o 

1 


1 7 
i 


| 6 | 7 | | 
i i i i 


o 1 


1 

| 000 

1 Tag 
i 


1 

i in 


1 1 1 1 
| 110 j 111 | 000 | 


! 
000 j 


1 
■ 


15 -bit address 


1 


1 

i o 


i 

l 


76700 


1 

1 



Final Address 



+ 

1 I 
+ 
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FNP Address Calculation Example 1 
Reference To Address In Low-Order Memory Using Paged Addressing 

c (x2)=076700; c(x3)=077240; c(475)=004000; c(4175)=000000; c(4176)=133040 

+ -- + 

| Instruction: Ida 1,2 | 

+ 

I | 1 | 

I I 1 
000 I 000 I 001 i 

1- 

Delta I 



I o 



+- 

I 

I I I 

| 010 I 000 I 111 

+ 

Opcode 








000000001 
001 



\ / 
l_ 



+- 

I 
+- 




000 



I Tag 
I 

! 

+ 

I Tag 

I 

| 000 

I 

I o 



-+ 

I 

-+ 

I 
I I I i I 

111 I 110 I 111 I 000 I 000 i 



X-register 2 
7 I 6 I 7 I 







15 -bit address 
76700 



Page No. 

Ill 110 1 

175 

\ / 
I 

V 



Offset 
11 000 000 
300 



j 

-+ 
I 



I 

I 

-+ 



+ - 

I 

I 

+- 



Page table entry @ 4175 
[c(475) + 175 -> 4176] 



-+ 
I 



















. o I i 

! I I I I I I 

| 000 I 000 I 000 I 000 j 000 I 000 j 
+ — --+ 

I Page addr mod 256 | |Act| | 

I I 1 i I 
i 000 000 000 I 00 j i 00000 i 
^ ... — ___ __ — 1_ 



+- 

I 
+- 



Final Address 
7 | 6 | 7 | 



-+ 

I 
-+ 
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FNP Address Calculation Example 3 
Reference To Address In Extended Memory 

c (x2)=076700; c(x3)=077240; c(475)=004000; c(4175)=000000; c(4176)«133040 



+ - + 

| Instruction: Ida 1,3 j 

+ ..-...._-.-...... ._..__+ 

|3|0|7|0|0|1| 

I I I I I I I 

j Oil j 000 j 111 I 000 I 000 I 001 I 

+------. ..__..--_-----.--+ 

I I I Tag | Opcode | Delta | 
j j j j i 

| i 11 | 000111 1 000000001 j 

I I I I I 

| | 3 | 07 | 001 | 

+ 



\ / 
1 


\ / 
1 




V 








X- register 3 


1 



+- 




000 
Tag 


Tag 
000 





7 I 7 I 2 I 4 I I 

I I I I I 
111 j 111 | 010 I 100 I 000 j 

- — -_-.--+ 

15 -bit address I 



77240 
Page No. 
Ill 111 
176 



\ / 

V 



Offset 
10 100 000 

240 
\ / 



-+ 
I 



I 

I 
• -+ 



| Page table entry @ 4176 

| [c(475) + 176 -> 4176] 

+ — 

|1|3|3|0|4|0 

I I I I I I 

j 001 I 011 I 011 I 000 I 100 I 000 

+------- 

I Page addr mod 256 | |Act| 

I III 

j 001 011 Oil j 00 I 1 I 00000 

+ ---- 

-\ /------- 



+ 

I 

_+ 

"l 1 

+ 



Final Address 
3 I 3 I 2 I 4 



-+ 

I 
-+ 



• -+ 



I 3 | 



-+ 



2 | 4 

I 
010 | 100 



| 001 I Oil I Oil 

+- - ---- 

I 001 Oil Oil I 10 100 
+ 



I o 

I 

I 000 



000 



I 

-+ 



/ 



J 
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I HSLA 

I High-Speed Line Adapter 

I Emulated in 6670s 

I All communications lines are connected to HSLAs 

I Maximum of 32 channels per HSLA 

I Maximum of 3 HSLAs per FNP => maximum of 96 channels per FNP 

I HSLAs do much of the work of running a channel, freeing up the FNP's 
CPU 

I Set and detect RS232 signals 

I Interrupt FNP when a signal changes 

J Read incoming characters into a buffer 

I Interrupt FNP when action is required 

I Buffer full 

I BREAK condition 

I Interesting character (such as CR, LF, EOT) read 

I Character Control Table (CCT) tells HSLA what characters 
are interesting 

I Does not do echoing 

I Send buffer of characters to terminal 

I Interrupt FNP when finished 

I Old FNPs had HSLAs and LSIAs (Low- Speed Line Adapters) 

I Channel names 

I One component for each level of multiplexing 

I FNP. H/L 99 

I b.hlOl 

I FNP . H/L 99 . SUB 

I a.h006.prtl 

I Mother/Daughter Boards 
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I HSLAs are emulated by Mother and Daughter Boards 

I Communications lines are connected to daughter boards 

1 Two lines are connected to each daughter board 

I There are different types of daughter boards for different types 
of lines 

I Asynchronous 

I Autocall channels fJ<?^S &* g °*'* " To c tU ffjr 

I BSC 

I G115 

I HDLC *.3l< Co«^<tC^C>K> ofAy \ tU*r>e l V ^?T feeuvd 
I HDLC daughter boards only have one line connected instead of two 
1 Daughter boards are properly known as CIAs 

J Communications Line Adapter 
I Daughter boards are mounted on mother boards 

J Four daughter boards can be mounted on one mother board 

I Maximum combined speed of lines on mother board is 72KB 

I An FNP can have up to 16 mother boards 

I 12 mother boards 4 daughter boards 2 lines => 96 lines per FNP 

I 4 mother boards are the equivalent of an HSLA (32 lines) 

I Mother boards are properly known as HMLCs 

I High-speed multi-line controller 
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Mother/Daughter Boards 



|a.h231 a.h230| |a.h229 a.h228| |a.h227 a.h226| |a.h225 a.h224| 
I CIA I | CIA || CLA || CLA | 

I OA^-t-r W ; I |_| |_| J 

HMLC H&lftr fie^nJ 



|a.hl07 a.hl06| |a.hl05 a.hl04| |a.hl03 a.hl02| |a.hl01 a.hl00| 

I CIA || CLA || CLA | | CLA | 

-I l_l l_l l_l l_ 

I 
HMLC | 

i 



|a.h031 a.h030| |a.h029 a.h028| |a.h027 a.h026| |a.h025 a.h024| 
I CLA || CLA || CLA | | CLA | 

-I l_l l_l l_l I 

I 

I HMLC 



|a.h023 a.h022| |a.h021 a.h020| |a.h019 a.h018| |a.h017 a.h016| 
I CLA || CLA || CLA | | CLA j 
I I — I l_l l_l I. 



i 
HMLC l 



|a.h015 a.h014| |a.h013 a.h012| |a.h011 a.h010| |a.h009 a.h008| 
I CLA || CLA || CLA | ! CLA j 

I l_l l_l l_l I 

HMLC 



|a.h007 a.h006| |a.h005 a.h004| |a.h003 a.h002| |a.h001 a.h000| 
I CLA || CLA || CIA |j CLA | 



I [ 

I HMLC | 



o HMLC = Mother Board 
o CLA = Daughter Board 



FNP Hardware Description 
MCS Overview F86 Page 1-41 



I DIA 

I Direct Interface Adapter 

I Connects Multics IOM to FN? IOM 

I 200KBit/sec smart controller 

I DIA can: 

I Send interrupts in both directions 

I Transfer data between memories of FNP and Multics at request of 
either 

I MCS does not use all these possibilities, i.e. FNP initiates all data 
transfers 

I Can have 2 DIAs per FNP 

\ But Multics will view each DIA as a separate FNP 
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a MCS Manuals 

I AN85: Communication System SDN 

I MCS Internals, both Ring and FNP 

I Theoretically unavailable: last update MK7.0 
I CC75: Multics Administrators' Manual- -.Communications 
I AG93: Multics Subroutines and Input/Outpt;.t Modules 
I AG91: Multics Programmer's Reference Guide 

I TTF described in Appendix B 

I Input conversion rules explained in Chapter 3 
I AN87: Hardware and Software Formats PLM 

I Theoretically obsolete and unavailable 

I Chapter 6 has FNP data formats 
I DD01: DN355/6600 Macro Assembler Program 
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MCS Administration 

CMF/CDT 

Channel Definition Table 

CDT describes all configured FNPs, multiplexers, lines 
Created from ASCII source file Channel Master File 
An Answering Service Database 
Stored in >scl>cdt 

Used by Initializer to manage lines, logins, etc. 
Used to initialize Ring databases at Multics bootload 
I Ring Databases are not stored permanently 
I Used to initialize FNP databases at FNP bootload 
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Spare_channel_count : 
FNP_required_up_time : 



Check_acs : all ; 

FNP: a; 

type: DN6670; , . ; ■ ^ a p ,-\ » 

lsla: 0; w^^r^"* C ° *' 

hsla: 3; 

memory : 64 ; 

image: >sldd>mcs>info>fnp_a; 

service : active ; 



Sample CMF 

li A II, V\.^ & T^^tLoJ? o\Rff^'->-«) 

10 . QUo— * Yo« V *& CUto.*iUs •*" . ^ 



^K 



C^U ^oB 



name : a . cOOO ; 
baud: 9600; 
service: slave; 



comment: "COLTS executive channel"; 
line_type: COLTS; terminal_type : none; 



name : a . hOOO ; 
baud: 1200; 
service: mc; 



comment: "console pupitre" ; 

line_type: ASCII; terminal_type : ROSY; 

attributes: hardwired, dont read_answerback ; 



name : a . hOOl ; 
baud: 1200; 
service: login; 



comment: "console datanet" ; 

line_type: ASCII; terminal_type : ROSY; 

attributes : hardwired , dont_read_answerback ; 



name: a.h002; 
baud: 1200; 
service: login; 



comment: "AJ510 dans salle de consoles 125"; 
line_type: ASCII; terminal_type : AJ510; 
attributes : hardwired , dont_read_answerback ; 



name: a.h003; 
baud: 1200; 
service: login; 



comment: "AJ860 dans salle de consoles 121"; 
line_type: ASCII; terminal_type : AJ860; 
attributes: hardwired , dont read answerback; 



/*** a.h006 is X.25 Sync HDLC daughter. This board steals a.h007 as well. */ 



name: a.h006; 
comment : 
service : 

multiplexer_type : 
baud: 

terminal_type : 
line_type : 



"X.25 canal principal 113001300"; 

multiplexer ; 

x25; 

9600; 

X25_TRANSPAC ; 

X25LAP; 



name: a.h006.d01-a.h006 .d02; 
service: autocall; 
generic_destination: "transpac" ; 
comment: "X.25 dial_out sub - channel " ; 

name: a.h006 .001-a.h006.013 ; 
service: login; 

comment: "X.25 login sub-channel"; 

terminal_type : ascii_crt; 
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baud: 
attributes : 



1200; 
dont_read_answerback ; 



name: a.h008; comment: "connexion stations HASP"; 
baud: 4800; line_type: BSG; terminal_type : HASP_HOST; 
mul t ip 1 exer_typ e : hasp ; 
service: multiplexer; attributes: A hardwired; 



name: a.h008,opr; 
service: 
line_type: 
terminal_type : 

name : a . b.008 . rdrl ; 
service: 
" line_type: 
terminal_type : 

name: a.h008.prtl; 
service: 
line_type : 
terminal_type : 



slave; 
BSC; 

HASP HOST; 



slave; 

BSC; 

HASP_H0ST; 

slave; 
BSC; 
HASP_HOST ; 



name: a.h008.punl; 
service: slave; 

line_type: BSC; 
terminal_type : HASP_H0ST; 

name: a.b.010; comment: "Questar dans le bureau Adj emian- Weber " ; 
baud: 4800; line_type: ASCII; terminal_type : VIP7205; 
service: login; attributes: hardwired, dont_read answerback; 
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I CMF delivered in >udd>sa>a 
I FNP_required_up_time : 

[ Global keyword 

J 2 crashes in this time => no reload 

I Applies to lower-level multiplexers as well 
J Spar e_channe l_c ount : 

I Global keyword 

I Number of extra entries in ring databases 

I Adding CDT entries for which there is no room in ring databases 
causes problems 

I Other global keywords 

I Define default values for omitted local keywords 

I FNP: 

I One FNP statement for each configured FNP 

J Followed by information about the FNP 

I type: 

I dn6670 <$Wf'-t f° r A' 1 
I memory : 

I Memory size in Kwords 
I hsla: 

I Number of HSLAs: can always say 3 

I Must have one line declared on HSLA before using HSLA 1 

1 Likewise for HSLA 1 and 2 
I image : 

I Pathname of image to load in FNP 
1 service: 

I active or inactive 
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I name: 

I One name statement for each configured channel 

I Followed by information about the channel 

I Can have a range of channel names, e.g. a.h006.001-a.h006 .016 

{ comment : 

I Comment stored in CDT 

I Not like /* comments */ which are ignored in CMF 

I Important to use comments to document 

I Also important to have well -organized CMF 
I baud: &?S 

I Up to 19.2KB for async, 72KB for sync 

I 110, 133, 140, 300, 600, 1200, 1800, 2400, 4800, 7200, 9600, 
19200, 40800, 50000, or 72000 

I line_type: 

I Line protocol: ASCII, G115, BSC, VIP, POLLED_VIP, or X25LAP 

I Cannot be changed by user 

J service: 

I login 

I Loaned to process for duration of process 

I Initializer owns all lines 

| slave 

I Loaned to existing process, returned when finished or at 
end of process 

I Requested by sending wakeup to Initializer (using 
dial_manager_) 



I Example: Used by I/O daemons to attach printers, readers, 
etc . 

I mc 



etc - u <r^cc ?f v /~ h.lm 



I Like slave, but for the Initializer's own use 
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I Used for operator terminals 

I autocall 

1 Like slave, but Initializer makes requested phone or 
network connection before loaning it 

I inactive 

I Not listened to when FNP boots 

I Useful for holding a spot for a line that is not yet 
physically installed 

I multiplexer 

I Line is a multiplexer channel 

I multiplexer_type statement must be used as well 

J multiplexer_type: 

I ibm3270, vip7760, hasp, x25, or sty 

I dataset_type : 

1 Used mostly for half- duplex modems 

I Require special handling of RTS , CTS , etc. 

I terminal_type : 

I Can be changed dynamically by user 

I For multiplexer, TTF entry gives multiplexer-specific parameters 
in the additional_info field 

I generic_destination: 

I Valid for autocall and slave lines 

I Allows users to attach line without knowing channel names 

I Useful to group together channels , allow changing channel 
assignments without affecting users 

I charge : 

I Specifies a surcharge for using the channel 

J For login lines this is in addition to connect charges 
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I Must correspond to device type in installation parms 
I check_acs : 

I ACS Segments in >scl>rcp 

I E.g. >scl>rcp>a.h001.acs n v it 4cc<js tf. ^CW QrN 

I Keywords specify when access checking is to be done 

I login 

I slave 

I priv_attach 

I dial_in 

I dial_out 

I all 

I Default is priv_attach, dial_out 

I attributes : 

I hardwired 

I Eliminates use of the login_time parameter in 
installation_parms 

I set_modes 

I Modes are set according to default terminal type at dialup 

I Only attribute that is on by default 
I dont_read_answerback 

I System does not send A E (ENQ) at dialup to request 
terminal's answerback 

I check_answerback 

I See answerback statement 

I audit 

I See access_class statement 
I none 

I A audit , A check_answerback , A dont_read_answerback , hardwired 
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I Default is A 

set_modes , A audit, A check_answerback, A dont_read_answerback, hardwired 

I answerback: 

I Specifies expected answerback for terminal 

I If check_answerback attribute is set, any other answerback will 
be refused connection 

I access_class : 

I Specifies the AIM classes of users allowed to login on the line 
I Enforced if the audit attribute is set Gu^TvQao^I^ 

I ini t i al_c ommand : 

I Preaccess command (e.g. login, modes, ttp, etc.) to be executed 
at each dialup 

| cv_cmf 

I Converts CMF into CDT 

I Usually CMF.cmf -> CMF.cdt 

I Resulting segment has same format as >scl>cdt but with no dynamic 
information 

I install 

I Initializer is the maintainer of CDT 

I Sends a request to Initializer 

I Initializer merges dynamic info from existing CDT with info from new 
CDT 

I Requires access to >scl>admin_acs>cdt. install. acs 
I Adding, deleting, changing channels 

I Many CMF changes do not take affect immediately 
I Some require FNP reboot to take affect 

I Tables 5-1 and 5-2 in CC75 explain when changes take effect 
I Most important are adding lines and changing speed of lines 
I Require FNP reboot 
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I Two commands for displaying information from CDT 
I display_cdt 

I Gives detailed information on CDT entries 
I tty_lines 

I Gives brief information on CDT entries 
I reset_cdt_meters resets n_dialups, n_logins, dialed_up_time ma/Qp f>>r\ 
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display_cdt 



CDTE at 515 | 15360 



In_use : 


3 (dialed) 


name: 


a.hll4 


comment: 


DKU7102 sur sous canal mpx trt de Paris2 


charge_type : 


(none) 


service_type: 


1 (login) 


current_service_type : 


1 (login) 


dim: 


1 (tty) 


line_type : 


1 (ASCII) 


terminal_type : 


DKU7102 


baud_rate : 


1200 


f np_no : 


1 (a) 


flags . attributes : 


hardwired , dont read answerback , check acs; 


event : 


000470001164407777000107 


tra_vec : 


3 (wait login line) 


count : 


1 


twx: 


46 


state: 


5 (dialed up) 


current_terminal_type : 


AJ510 


cur_line_type : 


1 (ASCII) 


tty_id_code : 


none 


process: 


77777 |1 


next_channel : 





n_dialups : 


393 


n_logins : 


348 


dialed_up_time : 


1083 hrs 45 mins 11 sees. 


dialup_time : 


02/20/84 1727.4 hfh Mon 


recent_wakeup_count : 


1 


recent_wakeup_time : 


02/20/84 1807.9 hfh Mon 
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Values for tra_vec in display_cdt output 
and WP column in tty_lines output 



1 wait_dialup 

2 wait_answerback 

3 wait_login_line 

4 wait_login_args 

5 wait_old_password 

6 wait_password 

7 wait_new_password 

8 wait_logout_sig 

9 wait_logout 

10 wait_logout_hold 

11 wait_detach 

12 wait_new_proc 

13 wait_remove 

14 wait_fin_priv_attach 

15 wait_dial_release 

16 wait_dial_out 

17 wait_hangup 

18 wait_slave_request 

19 wait_greeting_msg 

20 wait_delete_channel 

21 wait_connect_request 

22 wait_tandd_hangup 

23 wait_fin_tandd_attach 

24 wait_discard_wakeups 

25 wait_before_hangup 



Channel waiting for dialup. 
WRU sent, waiting for reply- 
Greeting typed, wait for login command. 
Want rest of login line 

"-cpw" was specified. Wait for old password. 
Waiting for password. (If "-cpw", repeat of new one.) 
"-cpw" was specified. Wait for new password 
Channel is hooked up. Wait for logout. 
A logout has been requested. Wait for process to die 
As above but don't hang up when it dies. 
As above but ignore channel afterwards. 
As above but make new process and continue. 
As above but completely expunge channel. 
When channel dials up, connect it to user 
Waiting for master process to release. 
Waiting for auto call to complete 
Wait for the hangup event to occur for a channel 
Ignore line until someone asks 
Print greeting message and wait for login line 
Channel deleted - mark cdte after process is destroyed 
logged in; awaiting request re disconnected processes 
when channel hangs up, proceed with t & d attachment 
when channel dials up, finish t & d attachment 
disregard all wakeups on channel 
allow output to print before hanging up 



■1 masked 

1 hung 

2 known 
5 dialed 



Values for state in display_cdt output 
and S column in tty_lines output 

Terminal channel is there, but masked by MCS 
Terminal channel is there, but dead. 
Channel being "listened" to, awaiting dialup. 
Channel is dialed up. This is normal state. 



free 

1 hung up 

2 listening 

3 dialed 

4 logged in 

5 logged in & proc 

6 dialing 

7 dialed out 



Values for in_use in display_cdt output 
and A column in tty_lines output 

Entry is empty. 

Entry is usable but tty is hung up. 

Entry is waiting for phone call. 

Entry is connected but login not complete , 

Entry is logged in but no process. 

Entry has a valid process . 

Entry (auto_call line) is dialing 

Entry (auto_call line) is in use 
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tty_lines 
Attached lines - 132 (size - 136) at 02/20/84 1817.0 



Name 

a.cOGO 

a.hOOO 

a.hOOl 

a.h002 

a.h003 

a.h006 

a.h006. 

a.h006. 

a.h006.d03 

a.h006.d04 

a.h006. 

a.h006. 

a.h006. 

a.h006, 

a.h006.004 

a.h006.005 

a.h006.006 

a.h006.007 



Type 

(NU) 

(NU) 

ROSY 

AJ510 

AJ860 

(NU) 



,d01 
,d02 



.d05 
,001 
.002 
,003 



ASCII_CAPS 

MINITEL 

ASCII_CRT 

ASCII_CRT 

ASCII_CRT 

ASCII_CRT 

ASCII CRT 



No. S WP A Saud User 

5 18 2 9600 COLTS executive channel 
5 1 1200 console pupitre 
125 5 3 3 1200 console datanet 
171 5 6 3 1200 AJ510 dans salle de consoles 125 
155 5 17 1 1200 AJ860 dans salle de consoles 121 
1 1200 X.25 major channel 
1649 1 18 1 300 X.25 dial_out sub-channel 
603 1 18 1 300 X.25 dial_out sub-channel 
228 1 18 1 300 X.25 dial_out sub -channel 
89 1 18 1 300 X.25 dial_out sub -channel 
38 1 18 1 300 X.25 dial_out sub -channel 
2788 5 8 5 1200 Desgoutte CNIP2 (none) X.25 login sub-channel 
1790 2 12 1200 X.25 login sub-channel 
1441 2 12 1200 X.25 login sub-channel 
1144 2 12 1200 X.25 login sub-channel 
910 2 12 1200 X.25 login sub-channel 
719 2 12 1200 X.25 login sub -channel 
587 2 12 1200 X.25 login sub -channel 



tty_lines 
field 



display_cdt 
field 



Name 

Type 

No. 

S 

WP 

A 

Baud 

User 



name: 

current_terminal_type : 

n_dialups : 

state: 

tra_vec : 

in_use: 

baud: 

comment : 
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h FNP Images 

I An FNP image is the software to load into the FNP 

I It consists of 'object decks' of individual programs bound together by the 
bind_fnp command 

I Two FNP images are delivered in system libraries 

J >unb>mcs 

I >unb>site_mcs 

I When the FNP is booted (during Multics bootload or by operator command or 
after FNP crash) this software is sent to the FNP from Multics 

I Before loading, configuration information from the CDT is patched in 

I An FNP's image must contain all software necessary to run the types of 
lines configured on the FNP 

I An image should not have unneeded software 

I This would waste FNP memory that could be used for I/O buffers 
1 Choosing the necessary modules is the main work in creating an image 

I All software must fit in <32K 

I The site_mcs and mcs images contain software for several types of lines 

I Sites create their own FNP images tailored to their FNP line- 
configurations 

I Often have a different image for each FNP 

1 Image is stored in a segment whose pathname is specified in CDT 
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FNP MODULES 


Module Name 


Needed if: 




dia_man 


always 




interpreter 


always 




scheduler 


always 




utilities 


always 




init 


always 




control_tables 


line_type: 


ascii; 


hsla_man 


hsla: >0; 




trace 


module : trace ; 


meters 


meter: yes 


: 


melt 


line_type : 


COLTS 


gll5_tables 


line_type: 


gH5 


bsc_tables 


line_type: 


bsc; 


x25_tables 


line_type : 


x251ap; 


hasp_tables 


multiplexer_type : hasp 


vip_tables 


line_type: 


vip 


polled vip tables 


line__type : 


polled_vip 


-ibm3270_tables 


line_type : 


bsc; + ibm3270 


acu_tables 


service : autocall ; 


autobaud_tables 


baud: auto 


i 


ic_sampler 


debug_fnp 


ic_sanrple 


breakpoint_man 


debug_fnp breakpoints 


console_man 


console : yes ; 



Which should happen: 

dliftc&y S 

always 
always 

a^ys" J.W> ^,f^^ *** **> *»~'* 
always 



always 

usually 5lo-s of f^S* 
usually \ 

usually *•«« ^ ^^ 



w 



„f»fW ,tx 



sometimes 
sometimes 
sometimes 
sometimes 
sometimes 
sometimes 
sometimes 
sometimes 
sometimes 

rare 
rare 
rare 



(Level-6 remotes) 
(HASP, IBM remotes) 
(real Multics x.25) 
(HASP) 
(Sync VIPs) 
(Polled sync VIPs) 
(3270 controller) 
(non-x.25 dialout) 






* A, <* S_ 



&*> 8- 
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I The bind_fnp command uses a control file with .bind_fnp suffix to select 
software modules to put in FNP image 
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/* bindfile for MCS, Multics Communications System */ 
version: 6.5d; 



64 . Cot<'S.Po 
no 



~J 



>o 



C^T, <f\Ww\j e W«r P\*Wl«"W<x- 



Isla: 0; 

hsla: 3; 
memory: 
console : 

printer : no 

meter: yes 



/* module load list - init module must be last */ 

order : scheduler , 

interpreter , 
control_tables , 
dia_man , 
melt, 
hsla_man, 
utilities, 
trace , 
bsc_tables , 
hasp_tables , 
x25_tables , 
meters , 
init; 

/* entry to init from bootload */ 

entry: is tart; 

/* table size specifications */ 



module : 


hsla_man; 


type: 


hsla; 


size: 


97; 


module : 


trace ; 


type: 


trace ; 


mask: 


317777; 


size: 


2048; 




end; 



/* trace enable mask */ 1 '- o^ 

/* mask bits: scheduler 

1 dia_man 

2 interpreter 

3 utilities 

4 lsla_man 

5 hslajman */ 
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bind_fnp 



fnp_a.bind._fnp [wd]>*.objdk 

I I 

__V V 

I I 

| bind_fnp fnp_a j 



V 
fnp_a 



fnp_a.bind_fnp ([contents [ wd]>fnp_a. search] )>*.objdk 

~ I I 

__V V 

I I 

| bind_fnp fnp_a -dr -list | 

I I 

I I 
V V 
f np_a f np_a .list 
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LDD Structure 



I 1 AA I 



+ + --- + 

I mcs j 
I 



+ ....+......+ + +......+ +....__.+. + 

| source | | object | | info | 
+-- + + + ----+-..---+ +- — .._.+.-- 1- 

I I I 

I ! I 

*.s, archive *. archive 355_macros 

macros. map355 
macros_asm 
s ite_mcs „ b lnd_f np 
site_mcs„list 
mcs.bind_fnp 
mcs.list 
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SLDD Structure 



+ — 

1 


sldd 


+ 

1 








1 


1 
. . — +... 

mcs 


1 


+--- 


■ +--• 


+ 



I I I 

I I I 

+ + + +- + + + + + 

I source | j object j j info | 
+ + — ---+ +- + + + + -+ 

I I I 

I I I 

* . s . ud . archive * . ob j dk f np_a . b ind_f np 

fnp_a.list 

fnp_a. search 

f np_b . b ind_f np 

fnp_b.list 
fnp_b . search 

355_macros 
macros .map355 
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I map355 

I The assembler for MAP355, the assembler language of the FNP 

j Actually calls GCOS emuxator to can asseniuiei 
J GCOS software is necessary 

I toto.map355 -> toto.objdk 

I -list control argument 

I -macro_file control argument 

I Default is -macro_file >ldd>mcs>info>355_macros 
I macros 

I Like include files for PL/I 

I gcos >ldd>mcs>info>macros_asm -truncate {-list -lower_case} 

I macros. map355 -> 355_macros 
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a Attributes in SAT/PDT 

Idialok SU~ ^ l: *°* 
I save_on_disconnect 
I disconnect ok 
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h Conf ig deck 

I PRPH FNP A A 18. ON 
I PARM TTYB 10240. 
I Default - 6K 
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h installation_parms 

I cwe_count 

J Initializer hangs up login line if more than cwe_count wakeups in 
cwe_time seconds 

I Default 10 
I cwe_time 

I Default 3 seconds 
I login_time 

I Initializer hangs up login line if no login in login_time seconds 

I Typical value 180 seconds 

I Not used for lines marked attibutes : hardwired 
I device_prices , device_names 

I Used in conjuction with charge__type : in CDT 



installation_parms 
MCS Administration F86 Page 2-23 



b. Operator commands 

J load_mpx 

| Start FNF or lower -level multiplexer 

I Starting FNP means loading it with image 

I Then load lower- level multiplexers 

I And start listening to all non-multiplexed lines that are 
not service: inactive 

I Starting lower- level multiplexer is similar to listening to a 
non-multiplexed lines 

I Accept connection, and when connection is made initiate 
protocol 

I Done automatically during Multics bootload (during Answering Service 
startup) and after multiplexer crash 

J Done manually with load_mpx to change some line attrs, add lines 

I Any lines already in use must be hung up before reloading multiplexer 

| Use -force to force hangups 

1 dump_mpx 

I Stops multiplexer completely 

I If it is an FNP, a dump is taken 

I stop_mpx 

I Stops further dialups from being accepted by multiplexer 

I Used when an FNP with logged in users must be reloaded 

J stop_mpx 

I send_message or warn or bump fnp 

J load_mpx 

I Prevents automatic loading if done before Answering Service startup 

I start_mpx 

I Undoes the effect of stop_mpx 

I bump fnp tag 
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I Allows bumping of users on a single FNP 
I detach 

I Makes a line inactive, bumping any user connected on the line 

I remove 

I Like detach, but uses a more brutal method of terminating user's 
process 

I attach 

I Makes a line active, undoing the effect of detach or remove 

I Can also recover masked channels 
I accept 

I Accepts the line as an operator terminal 

{ Line must be service: mc, or can type 'dial system' on a login 
terminal 

I drop 

I Undoes the affect of an accept 
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Advanced MCS User Features 

Terminal Characteristics 
I Many terminal characteristics can be modified 

J Character set/code 

I Character sequences to move carriage/cursor 

I Use of tabs 

I Padding 

I Terminal initialization (set tabs, etc.) 

I Line/page length 

I Character echoing modes 
I These characteristics can all be modified several different ways 

I TTF 

I stty 

I io_call control, io_call modes 

I iox_$control , iox_$modes 

I We will look at how to modify them in per terminal - type in TTF and 
dynamically using iox_ 

I stty and io_call are just command- level interfaces to iox_ 
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H TTF/TTT 

I ASCII source Terminal Type File is used to produce Terminal Type Table 

I Has three major types of information 

I Characteristics of different terminal types for use by Ring and FNP 

I Characteristics of different terminal types for use by the Video 
System 

J Definition of some preaccess commands 

I Definition of terminal answerback^ 
I System TTT is in >scl>ttt I C r 
I cv_ttf 

I Converts TTF to TTT 

I Usually TTF.ttf -> TTF.ttt 
I install 

I The install command is used to install new TTT in >scl>ttt 

I Unlike CMF, there is no dynamic information 

I Process calling the install command does the installation itself 

I >scl>ttt is protected by ring brackets of 1,5,5 

I Access required to >scl>admin_acs>ttt. install. acs 
I Can use private TTTs 

I set_ttt_path 

| Specifies the TTT to use in process 

I Preaccess command and answerbacks not meaningful in private TTT, 
since they are only handled by Initializer 

I display_ttt 

I Used to display some or all of a TTT 

I TTF Syntax 

I TTF is a typical source file for a table with statements identified 
by keywords 
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I Many statements take characters or lists of characters as arguments 
I Such characters may be specified in several different ways 

{ Single unquoted character, e.g. X 

I Single quoted character, e.g. "X" or " ; " 

I 1 to 3 digit octal number, e.g. 033 

{ Control character name, e.g. ESC 

I Control characters in form A A 
I Repetition of single characters or groups of characters is possible 

I Uses (N) for repetition factor 

I < ... > to group characters 
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Terminal Type Definition 

Input_conversion: standard_input_conv ; 

/***** Typical ASCII teleprinter terminal *****/ 
terminal_type : ASCII; 
modes : default , 1179 , A pl , can_type=overs tr ike ,hndl quit , 
fulldpx , echoplex , crecho , If echo , A tabs , tabecho ; 



bauds : 


110 




133 


150 


300 


vert_nl_delays : 







1 


1 


5 


horz_nl_delays : 


0. 


00 


0.012 


0.025 





const_tab_de!ays : 
















var_tab_delays : 







0.180 


0.250 





backspace_delays : 
















vt_f f_delays : 


9 




24 


29 


59 



600 


1200 


9 


18 


0.060 





2 


3 


0.500 


1 


1 


2 


100 


200 



,019 0.060 0.120 

2 3 

,250 0.500 1.000 



output_conversion: ascii_output_conv; 
special: ascii_special; 
line_types: ASCII, VIP, P0LLED_VIP; 
old_type : 11 ; 

/***** ASCII teleprinter terminal (upper -case only) *****/ 
terminal_type : ASCII_CAPS like ASCII; 

modes : default , 1179 , A pl , can_type=overstrike .hndlquit , capo , 
fulldpx , echoplex , crecho , If echo , A tabs , tabecho ; 

special: ascii_caps_special; 

input_translation: ascii_caps_input_trans ; 

old_type: 7; 

/***** Typical ASCII crt terminal *****/ 
terminal_type : ASCII_CRT like ASCII; 

modes : default , 1179 , pl23 , can_type=replace , hndlquit , scroll , 
fulldpx. echoplex, crecho , If echo , A tabs , tabecho ; 

bauds: 110 133 150 300 ' 600 1200 

/***** ASCII CRT terminal (upper -case only) *****/ 
terminal_type : ASCII_CRT_CAPS like ASCII_CAPS ; 

modes : default , 1179 ,pl23 , can_type=replace .hndlquit , scroll , capo , 
fulldpx , echoplex , crecho , If echo , A tabs , tabecho ; 

bauds: 110 133 150 300 600 1200 

/***** TeleVideo, Inc. Model TVI-912 *****/ 
terminal_type : TVI912 like ASCII_CRT; 

modes : default , 1179 , pl23 , can_type=replace , hndlquit , scroll , 
fulldpx, echoplex, crecho , If echo , tabs , A tabecho ; 

initial_string: ESC 3 CR ESC 1 (7) <(10) <SP> ESC 1> CR; 

special: tvi912_tvi920_special; 
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a tty_ Modes and Control Orders 

I Look at many functions of Ring Zero and FNP by looking at user interface 

j The tty_ I/O module and asynchronous lines are used as examples 

I Much processing is the same for non-multiplexed synchronous lines, and for 
subchannels of multiplexers 

I Comparison with other line types is made whenever possible 

I Terminal Initialization 

I Initial string specified in TTT 

I Sent to terminal at dialup time 

J Generally used to set tabs 

I Can be resent using send_initial_string control order 

I Only useful for asynchronous terminals 

I Input Conversion, Translation, etc. 

I All terminal input goes through four steps of conversion and 
translation 

I Translate to ASCII . v 

I Put in canonical form S^S^- ' 

I Process input escape sequences 

I All of these steps are performed in ring 

I All of these steps are exactly the same for all line types: 

asynchronous lines, non-multiplexed synchronous lines, multiplexer 
subchannels 

I Translation v<- oW-tc S o ft*. S~**Vtey> 6^<W> *"* ^ 

I Input is translated into ASCII 
J Similar to PL/I translate builtin 

I Does not change size of input string 
I Does not change what is echoed to terminal 

I Echoing is done in FNP, translation is done later in Ring 
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I ctl_char mode 

I When a terminal is in ctl_char mode, control characters are 
accepted as input 

I Otherwise control characters are discarded 

I If terminal is not in ctl_char mode, a second translation 
is done to translate all control characters into NULs 

I NULs are normally discarded later in the input 
translation/conversion process 



tty_ Modes and Control Orders 
Advanced MCS User Features F86 Page 3-6 



Input Translation 
Extract From Terminal Type File 



terminal_type : 



input__translation: ascii_caps_input_trans ; 





















• ( 


To 


3# 






'j 


translation table: ascii 


caps input trans ; 
















000 001 


002 


003 


004 


005 


"006 


007 


/*NUL 


SOH 


STX 


ETX 


EOT 


ENQ 


ACK 


BEL 


(000-007)*/ 


010 Oil 


012 


013 


014 


015 


016 


017 


/*BS 


TAB 


LF 


VT 


FF 


CR 


SO 


SI 


(010-017)*/ 


020 021 


022 


023 


024 


025 


026 


027 


/*DLE 


DC1 


DC2 


DC3 


DG4 


NAK 


SYN 


ETB 


(020-027)*/ 


030 031 


032 


033 


034 


035 


036 


037 


/*CAN 


EM 


SUB 


ESC 


FS 


GS 


RS 


US 


(030-037)*/ 


040 041 


042 


043 


044 


045 


046 


047 


/*SP 


! 


n 


# 


$ 


% 


& 


r 


(040-047)*/ 


050 051 


052 


053 


054 


055 


056 


057 


/*( 


) 


* 


+ 


) 


- 


. 


/ 


(050-057)*/ 


060 061 


062 


063 


064 


065 


066 


067 


/*0 


1 


2 


3 


4 


5 


6 


7 


(060-067)*/ 


070 071 


072 


073 


074 


075 


076 


077 


/*8 


9 


; 


) 


< 


- 


> 


1 


(070-077)*/ 


100 141 


142 


143 


144 


145 


146 


147 


/*<§ 


A 


B 


C 


D 


E 


F 


G 


(100-107)*/ 


150 151 


152 


153 


154 


155 


156 


157 


/*H 


I 


J 


K 


L 


M 


N 





(110-117)*/ 


160 161 


162 


163 


164 


165 


166 


167 


/*P 


Q 


R 


S 


T 


U 


V 


W 


(120-127)*/ 


170 171 


172 


133 


134 


135 


136 


137 


/*X 


Y 


Z 


[ 


\ 


] 


A 




(130-137)*/ 


140 141 


142 


143 


144 


145 


146 


147 


/*' 


a 


b 


c 


d 


e 


f 


g 


(140-147)*/ 


150 151 


152 


153 


154 


155 


156 


157 


/*h 


i 


J 


k 


1 


m 


n 


o 


(150-157)*/ 


160 161 


162 


163 


164 


165 


166 


167 


/*P 


q 


r 


s 


t 


u 


V 


w 


(160-167)*/ 


170 171 


172 


173 


174 


175 


176 


177 


;/*x 


y 


z 


{ 


1 


} 


" 


DEL 


(170-177)*/ 



Extract from tty_convert . incl . pll 
Used for get_input_translation and set_input_translation control orders 

del CV_TRANS_VERSI0N fixed bin int static options (constant) init (2); 

del 1 cv_trans_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 cv_trans like cv_trans ; 

del 1 cv_trans based aligned, 

2 value (0:255) fixed bin (8) unal; 
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I Canonicalization W/Mol u S^q ^ *-4VT v fy^T cn^roack 

I Backspaces present a particular problem on input 

I When we see the string abc in a file we can't know if it was 
originally typed in 

I abc<BSXBSXBS> 

I a<BS>_b<BS>_c<BS>_ 

I Or even ab<BS>_<BSXBS>a<BS> <SPXBSXBS>c 

I Similarly if we see the line abc on a CRT screen it may have 
been typed an infinite number of different ways 

I abd<BS>c, for example 

I Ganonicalization tries to apply a what-you-see-is-what-you-get 
rule 

I There are two separate cases, for hardcopy terminals and CRTs 

I can_type=overstrike is for hardcopy terminals 

I If multiple characters are typed in the same column, the 
first characters are overstruck on paper 

I Input is canonicalized to be column by column 

I Multiple characters in same column are put in sorted order, 

<3ATiATj3t*j=>r1 Hit Kflr»Ve-na^oe 
1 — j ~ — — "— t-—— ~ — 

I In the example above, canonical form is _<BS>a_<BS>b_<BS>c 

I can_type=replace is for screen terminals 

I If multiple characters are typed in the same column, the 
first characters are replaced on screen 

I Input is canonicalized to be column by column 

I Only the last character in each column is retained, with no 
backspaces 

{ Note that this does not make BS the erase character 

I ab<SPXSPXBS>c and ab<SPXSP>#c give different results 

I can mode 

J Turns canonicalization on or off 
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I Erase and Kill Characters 

I # is normal erase character, @ is normal kill character 
J Any other characters may be substituted 
I erkl mode 

I Turns erase and kill processing on or off 



Erase and Kill Characters 
Extract From Terminal Type File 



terminal_type : 



erase: X; 
kill: A C; 



Extract from tty_editing_chars.incl.pll 
Used for get_editing_chars and set_editing_chars control orders 

del 1 editing_chars aligned based (editing_chars_ptr) , 
2 version fixed bin, 
2 erase char (1) unaligned, 
2 kill char (1) unaligned; 

del editing_chars_version_2 fixed bin internal static init (2) ; 



1 Process input escape sequences 

I Each input character is looked up in input conversion table 

J Gets extra processing if marked 

I Break character 

I Used as end of line in get_line calls 

I White space removed in front of break character 

I Doesn't mean that the character will cause line to be 
read immediately 

I Other modes determine when FNP sends line to Multics 

I Discard (\^ u V P^-A ()-><} 
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I Characters thrown away 
I Formfeed 

I Discarded if page length > 

I Dates from early days of EOP processing 
I Escape 

I Not to be confused with ASCII ESC (033) 

I Usually backslash character 

I Changes interpretation of following character(s) 

I \<NI> \# \@ \007 \\ 

I Other escape sequences may be defined using input 
conversion table plus special table 

I esc mode 

I Can be turned off to inhibit escape sequence processing 






tty_ Modes and Control Orders 
Advanced MCS User Features F86 Page 3-10 



Input Conversion 
Extract From Terminal Type File 



terminal_type : ... 
input_conversion : standard_input_conv; 



convers ion_tab le : s tandard_input_conv ; 
03 00 00 00 00 00 00 00 /* NUL SOH STX ETX EOT ENQ ACK BEL (000-007) */ 
00 00 01 00 04 00 00 00 /* BS TAB LF VT FF CR SO SI (010-017) */ 
00 00 00 00 00 00 00 00 /* DLE DG1 DC2 DC3 DC4 NAK SYN ETB (020-027) */ 
00 00 00 05 00 00 00 00 /* 
00 00 00 00 00 00 00 00 /* SP 
00 00 00 00 00 00 00 00 /* ( 
00 00 00 00 00 00 00 00 /* 
00 00 00 00 00 00 00 00 /* 8 
00 00 00 00 00 00 00 00 /* @ 
00 00 00 00 00 00 00 00 /* H 
00 00 00 00 00 00 00 00 /* P 
00 00 00 00 02 00 00 00 /* X 
00 00 00 00 00 00 00 00 /* 
00 00 00 00 00 00 00 00 /* h 
00 00 00 00 00 00 00 00 /* p 
00 00 00 00 00 00 00 03;/* x 



Extract from tty_convert.incl.pll 
Used for get_input_conversion and set_input_conversion control orders 

del CV_TRANS_VERSION fixed bin int static options (constant) init (2) ; 

del 1 cv_trans_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 cv_trans like cv_trans; 

del 1 cv_trans based aligned, 

2 value (0:255) fixed bin (8) unal; 

del (INPUT_CONVERT_ORDINARY init (0), 
INPUT_C0NVERT_BREAK init (1), 
INPUT_CONVERT_ESCAPE init (2) , 
INPUT_CONVERT_DISCARD init (3), 
INPUT_C0NVERT_F0RMFEED init (4), 
INPUT_CONVERT_PRECEDENCE_DISCARD init (5) 
) fixed bin (8) unaligned internal static options (constant) ; 



AN EM 


SUB 


ESC 


FS 


GS 


RS 


US 


(030-037) */ 


P ! 


n 


# 


$ 


% 


& 


8 


(040-047) */ 


) 


* 


+ 


S 


- 


» 


/ 


(050-057) */ 


1 


2 


3 


4 


5 


6 


7 


(060-067) */ 


9 


* 


> 


< 


- 


> 


? 


(070-077) */ 


! A 


B 


C 


D 


E 


F 


G 


(100-107) */ 


I 


J 


K 


L 


M 


N 


O 


(110-117) */ 


Q 


R 


S 


T 


U 


V 


W 


(120-127) */ 


; y 


Z 


[ 


\ 


] 


A 




(130-137) */ 


a 


b 


c 


d 


e 


f 


S 


(140-147) */ 


i 


J 


k 


1 


m 


n 


o 


(150-157) */ 


1 q 


r 


s 


t 


u 


V 


w 


(160-167) */ 


y 


z 


{ 


I 


} 




DEL 


(170-177) */ 
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Special Characters Table 

(Only Parts Used In Input Conversion Are Shown Here) 

Extract From Terminal Type File 

terminal_type : ... 

special: ascii_caps_special; 

special_table: ascii_caps_special; 

(most or table is used m output conversion) 

input_escapes : /* <escape> <lc-alpha> -> <uc-alpha> (eg: \a -> A) */ 

"a" "A" "b" "B" "c" "C™ "d" "D" "e" "E" 

™f" °F" "»■ "G" "h" "H" "i™ "I" "i" "J" 

"k" "K", "1" "L", "m" "M" , "n" "N" , "o" "0", 

"u™ "U" , "v" "V" "w" "W" "x" "X" "v" "Y" "z" "Z" • 



Extract from tty_convert.incl.pll 

(Only Parts Used In Input Conversion Are Shown Here) 

Used for get_special and set_special control orders 

del SPECIAL_VERSION fixed bin int static options (constant) init (1) ; 

del 1 c_chars based aligned, 

2 count fixed bin (8) unaligned, 
2 chars (3) char (1) unaligned; 

del 1 special_chars_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 special_chars, 

(most of table is used in output conversion) 

3 escape_length fixed bin, 



3 input_escapes aligned, 

4 len fixed bin (8) unaligned, 

4 str char (sc_input_escape_len refer 

(special_chars_struc . input_escapes . len) ) unaligned, 

3 input_results aligned, 
4 pad bit (9) unaligned, 
4 str char (sc_input_escape_len refer 
(speeial_chars_struc . input_eseapes . len) ) unaligned; 

del 1 get_special_info_struc based aligned, 
2 area_ptr pointer, 
2 table_ptr pointer; 
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I All of the input translation and conversion steps can be bypassed 
I rawi mode V\p£0 w *vC> ~\ kpTF wo\y 



I uuupui- *=» 



onversion, Translation, etc. 



i All terminal output goes through three steps of conversion and 
translation 

I Capitalization 

I Formatting 

I Translation from ASCII 

I All of these steps are performed In ring 

I All of these steps are exactly the same for all line types: 

asynchronous lines, non-multiplexed synchronous lines, multiplexer 
subchannels 

I Capitalization 

{ capo mode 

1 If in capo mode^ t««asiate all alphabetics to uppercase 

J Formatting 

I 11 mode 

A ll or 11NN, e.g. 1179 

Insert <NL> after NN characters 

I pi mode 

A pl or plKN, e.g. pl23 

Stop with End of Page string after NN lines 

I End of Page string specifiable in special table 

Continue with CR or FF 

CR thrown away if on line by itself 

FF always thrown away if NN > 

Originally only FF was accepted 

I scroll mode 
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I Used in conjunction with pi mode 

I scroll intended for scrolling terminals 

I EOP after NN lines of continuous output 

I Line counter reset after user input 
I A scroll intended for non-scrolling screens, e.g. TEK4014 

I Counter not reset, user input adds to counter 

I EOP after NN lines of input or output 
I edited mode 

I In A edited mode, non-printing characters are output as 
octal escapes are printed, e.g. \000 

I In edited mode, non-printing characters are discarded on 
output 

I tabs mode /*""< « T ^ J ^ 

I In tabs mode, white space is optimized into minimum number 
of tabs and blanks 

I Terminal's tabs must have been set by initial string 
I red mode 

I In red mode, SO f\01fi ov RBS nmr\ii~asi !>•»■ *~o a d\ -,-..„-„ 
terminal to shift to color 

I SI (\017 or BRS, produced by ioa_ A B) changes back to 
normal 

I Used in some system error messages 

I Actually sends sequence from special table 

I On old terminals, shifted to red ribbon 

I On CRTs , can change to - inverse video 

I vertsp mode 

I In vertsp mode, FF and VT are sent to terminal 

I Actually sends sequence from special table 

I In A vertsp mode, FF and VT are sent as octal escapes 
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I Output Conversion 

I Output conversion uses the output_conversion and special 
tables 
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Output Conversion 
Extract From Terminal Type File 



terminal_type : ... 
output_conver s ion : ascii_output_conv ; 



conversion_table : ascii_output_conv; 

07 07 07 07 07 07 07 12 /* NUL SOH STX ETX EOT ENQ ACK BEL (000-007) */ 

04 03 01 05 06 02 10 11 /* BS TAB LF VT FF CR SO SI (010-017) */ 

07 07 07 07 07 07 07 07 /* DLE DG1 DC2 DG3 DC4 NAK SYN ETB (020-027) */ 

07 07 07 07 07 07 07 07 /* CAN 

00 00 00 00 00 00 00 00 /* SP 

00 00 00 00 00 00 00 00 /* ( 

00 00 00 00 00 00 00 00 /* 

00 00 00 00 00 00 00 00 /* 8 

00 00 00 00 00 00 00 00 /* @ 

00 00 00 00 00 00 00 00 /* H 

00 00 00 00 00 00 00 00 /* P 

00 00 00 00 00 00 00 00 /* X 

00 00 00 00 00 00 00 00 /* ' 

00 00 00 00 00 00 00 00 /* h 

00 00 00 00 00 00 00 00 /* p 

00 00 00 00 00 00 00 14;/* x 



EM 


SUB 


ESC 


FS 


GS 


RS 


US 


(030-037) */ 


I 


it 


# 


$ 


% 


& 


f 


(040-047) */ 


) 


* 


+ 


J 


- 


. 


/ 


(050-057) */ 


1 


2 


3 


4 


5 


6 


7 


(060-067) */ 


9 


I 


J 


< 


- 


> 


1 


(070-077) */ 


A 


B 


C 


D 


E 


F 


G 


(100-107) */ 


I 


J 


K 


L 


M 


N 





(110-117) */ 


Q 


R 


S 


T 


U 


V 


W 


(120-127) */ 


Y 


Z 


[ 


\ 


] 


A 




(130-137) */ 


a 


b 


c 


d 


e 


f 


g 


(140-147) */ 


i 


J 


k 


1 


m 


n 


o 


(150-157) */ 


q 


r 


s 


t 


u 


V 


w 


(160-167) */ 


y 


z 


{ 


1 


} 


~ 


DEL 


(170-177) */ 
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Extract from tty_convert.incl.pll 
Used for get_output_conversion and set_output_conversion control orders 

del CV_TRANS_VERSION fixed bin int static options (constant) init (2) ; 

del 1 cv_trans_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 cv_trans like cv_trans; 

del 1 cv_trans based aligned, 

2 value (0:255) fixed bin (8) unal; 

del (OUTPUT_CONVERT_ORDINARY init (0) , 
OUTPUT_CONVERT_NEWLINE init (1), 
OuTPUT_CONVERT_CR init (2), 
OUTPUT_CONVERT_HT init (3), 
OUTPUT_CONVERT_BS init (4), 
OUTPUT_CONVERT_VT init (5) , 
0UTPUT_C0NVERT_FF init (6) , 
0UTPUT_C0NVERT_0CTAL init (7) , 
0UTPUT_C0NVERT_RRS init (8), 
0UTPUT_C0NVERT_BRS init (9), 
0UTPUT_C0NVERT_N0_M0TI0N init (10) , 
0UTPUT_CONVERT_PEECEDENCE_NO_MOTION init (11), 
0UTPUT_G0NVERT_D0NT_SEND init (12) , 
OUTPUT_CONVERT_FIRST_SPECIAL init (17) 
) fixed bin (8) unaligned internal static options (constant) ; 
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Special Characters Table 
Extract From Terminal Type File 



terminal_type : 



special: ascii_caps_special; 



special_table 
new_line: 
carriage_return 
backspace : 
tab: 

vertical_tab : 
f orm_f eed : 
printer_on: 
printer_off : 
red_shif t : 
black_shift: 
end_of_page : 



ascii_caps_special ; 
CR LF; 
CR; 
BS; 
TAB; 
VT CR; 
FF CR; 



E P; 






yvtf I 



etLc 



h^tf 



I I- 



-~ Yet^'O&X 



9 



mput_escapes : 

ll£tt tip If 

if l-ii n ffn 

"p" "P" : 

it,, ii nTTii 



'U 



U" 



/* <escape> <lc-alpha> -> <uc-alpha> (eg: \a -> A) */ 



"b" "B" "c™ "C" "d" "D" "e" "E" 



"g" 



"G" 

in n n t n 
"AH 



"h" "H", "i" "I", 
"m" "M n , "n" T, 



n -* II 

ll„ll 



"J", 

o" "0", 

— ii "Qii n«.it «t>" "c" "S M "t" "T" 

V n nyil it^it iiTjTii n^tt ityti n„i! n^H it ., n 



•w 



lyl. 



"Z c 
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Extract from tty_convert.incl.pll 
Used for get_special and set_special control orders 

del SPECIAL_VERSION fixed bin int static options (constant) init (1) ; 

del 1 c_chars based aligned, 

2 count fixed bin (8) unaligned, 
2 chars (3) char (1) unaligned; 

del 1 special_chars_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 special_chars , 

3 nl_seq aligned like c_chars. 

3 cr_seq aligned like c_chars, 

3 bs_seq aligned like c_chars, 

3 tab_seq aligned like c_chars, 

3 vt_seq aligned like e_chars, 

3 ff_seq aligned like c_chars, 

3 printer_on aligned like c_chars , 

3 printer_of f aligned like c_chars , 

3 red_ribbon_shift aligned like c_chars, 

3 black_ribbon_shift aligned like c_chars, 

3 end_of_page aligned like c_chars, 

3 escape_length fixed bin, 

3 not_edited_escapes (sc_escape_len refer 

(special_chars_struc . escape_length) ) like c_chars , 

3 edited_escapes (sc_escape_len refer 

( special_chars_struc . escape_length) ) like c_chars , 

3 input_escapes aligned, 

4 len fixed bin (8) unaligned, 

4 str char (sc_input_escape_len refer 

( spec ial_chars_s true . input_escapes . len) ) unaligned , 

3 input_results aligned, 
4 pad bit (9) unaligned, 
4 str char (sc_input_escape_len refer 
(special_chars_struc . input_escapes . len) ) unaligned; 

del 1 get_special_info_struc based aligned, 
2 area_ptr pointer, 
2 table_ptr pointer; 
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I Translation 

I Translate from ASCII to terminal's character set 
I To bypass all of the above 

I rawo mode 

I All of the above output conversion/ translation is done in ring 

I Echoing 

I Echoing is done in the FNP 

I Echoing makes sense only for asynchronous terminals 

I Asynchronous terminals connected via X.25 are a special case 

I FNP cannot do echoing, because it does not know about logical 
channels f « 1 v^V.^c /*!* Cok<~i £ r °- ^Lla^ > <? f- ^ h « \ 

I Echoing could be done in Ring 0, but would be expensive 

I X.25 has parameters to tell PAD to do echoing 

I fulldpx mode 

I Specifies that line can send and receive at same time 

I Echoing implies fulldpx 

T fill 1 Ativ rfnps not- nirmlv oc?im'n(T 

I If "fulldpx, Multics will not send while receiving 

I echoplex mode 

I Each character sent by terminal is echoed back 

j No selection, translation, conversion, etc. possible. 

I lfecho mode 

I When CR is received, LF is sent to terminal and placed in input 
stream 

I NL (same as LF) is only true end-of-line character for 
Multics 

I When in lfecho mode, CRs will appear to be ignored 
I crecho mode 
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I When LF is received, CR is echoed 

I Not allowed for X.25 lines 

1 There is no X.25 parameter to have PAD do crecho 

I tabecho mode 

I When tab is received, FNP sends back spaces to move 
carriage/cursor to next tab stop 

I Not allowed for X.25 lines 

I There is no X.25 parameter to have PAD do crecho 

I Quit Handling 

I There are a number of steps in handling break condition 

I Handled both in ring and in FNP A <"*«•> K v - Pc,t * v 

I True break condition can only occur on asynchronous lines 

I Synchronous protocols such as POLLED_VIP, X.25 have ways to 
achieve similar effect 

J There are two separate controls on this handling 

I Quits are enabled or disabled by control orders 

I quit_enable control order 

I quit_disable control order 

J hndlquit mode 

-4 — If - quite enabled : 

I 1) FNP sends NL, if in hndlquit mode 

I 2) FNP flushes buffers, if in hndlquit mode 

I 3) FNP tells Ring 

J 4) Ring flushes buffers, if in hndlquit mode 

1 5) Ring wakes up user process, signalling "quit" condition 

I 6) Ring 4 default quit handler prints "QUIT" 

I For an X.25 line, FNP cannot handle individual logical channel 

I 1) PAD/X.25 network flush buffers, if in hndlquit mode 
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SV~r '^ s "**- a . Je + + 

I 2) PAD/X.25 network tell FNP (via control packet) 

"^ 13) FNP sends control packet to ring 

•n v C^- I *) R i- n S sends NL, if in hndlquit mode 
UffrtC 

"v o 
^pPavJ' \ 15) Ring flushes buffers, if in hndlquit mode 

v 16) Ring wakes up user process, signalling "quit" condition 

I 7) Ring 4 default quit handler prints "QUIT" 

I Polite, Replay 

I Sending output while user is typing can be disruptive 

I Modes exist to make it less disruptive 

I Valid only for asynchronous lines and X.25 subchannels 

I Handled in FNP 

I polite mode 

I If any output occurs while user is typing input line will hold 
output until user finishes input line 

I Timeout after 30 seconds 

I Some X.25 networks have parameter to have PAD handle this 

I prefixnl mode 

I Interrupting output is prefixed with a newline 

I If input line interrupted because A polite, or 30 second 
timeout 

I Not possible for X.25 lines 

I replay mode 

I Replays interrupted input line 

I If input line interrupted because A polite, or 30 second 
timeout 

I Not possible for X.25 lines 

I Non-line-oriented input 

J Normally the FN? buffers a line of input and then sends entire line 
to Multics 
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{ On the Multics (Ring 0) side, the user process is woken up whenever 
input is sent from FNP to Multics 

I There are ways to change when the FNP forwards data and when a user 
process is woken up 

} breakall mode 

I Causes FNP to forward each character to Multics 

I User process woken up for each character 

I Necessary or useful for certain applications 

I Input from devices that never send CR or LF 

I dial_out 

I Emacs and Video System 

I Comparatively expensive 

I Echo Negotiation ^voV g^cv^^a^- 

I Echo negotiation is an optimization to make it less expensive 
for Emacs and Video System 

I Typical situation in Emacs/Video is entering text at end of line 

I For each normal character that user types , all that needs to be 
done is echo and store 

I This is almost what FNP does in echoplex mode 

I Additional information needed 

I List of characters that require more than simple echo 

I Number of columns remaining on the current line of the 
screen 

I No documented user interface for echo negotiation 

I To use echo negotiation 

I set_echo_break_table control order 

I Input is table of 128 bits in table, telling FNP what 
chars to stop echoing on 

I Then call hcs_$tty_read_echoed 

I Input: buffer_ptr, buffer_size, columns_left 
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I Output: #characters returned, #characters echoed 

I For X.25 lines, cannot be handled in FNP, nor in PAD 

I Handled in Ring 

I wake_tbl mode 

Changes when user process is woken up 

Handled in Ring 

Valid for all types of lines 

Normally woken up for every input 

Sometimes better to wake up less often 

Consider qedx input mode 

qedx has almost nothing to do, and nothing to print, until a \ 
is read 

wake_tbl specifies that wakeup should be sent only when 
specified characters are in input 

Table must be set by control order before turning on wake_tbl 
mode _ 
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Wakeup Table 
Not settable in TTF 



Extract from set__wakeup__table_Info.incl.pll 
Used for set_wakeup_table control order 

del swt__info_version_l fixed bin static options (constant) init (1) ; 

del 1 swt_info aligned based (swt_infop), 
2 version fixed bin, 
2 new_table like wakeup_table , 
2 old_table like wakeup_table ; 

del wakeup_tablep ptr; 

del 1 wakeup_table aligned based (wakeup_tablep) , 
2 wake_map (0:127) bit (1) unal, 
2 mbz bit (16) unal; 



[ Padding 

1 Many hardcopy terminals handle normal characters at line speed 

J But require more time for carriage movement 

I Padding (i.e. delay) characters can be sent to allow time for 
carriage movement 

I Padding is done with NUL characters, which terminal discards 

I Padding can be done for CR/LF, Tabs, BS, FF 

I Specified in number of delay characters, or number of delay 
characters per column 

I Padding requirements are different at different speeds 

I Determining padding requirements is usually a matter of guessing and 
experimenting 

I Padding for output is done in Ring 

I Padding for echoed characters is done in FNP 

I Can be done for any type of line, but only makes sense for 
asynchronous lines and X. 25 subchannels 
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I For X.25 no padding will be done for echoed characters 

1 Not a problem 
I But X.25 does not know speed of terminal, only of multiplexed line 
I This has bad effects for padding 
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Delays 
Extract From Terminal Type File 



terminal_type : ... 














bauds : 
vert_nl_delays : 
horz_nl_delays : 
const_tab_delays : 
var_tab_delays : 
backspace_delays : 
vt_f f_delays : 


110 


0.00 



9 


133 
1 

0.012 


0.180 

24 


150 
1 

0.025 


0.250 

29 


300 
5 

0.019 


0.250 

59 


600 

9 

0.060 

2 

0.500 

1 
100 


1200 
18 
0.120 
3 

1.000 
2 
200 



Extract from tty_convert.incl.pll 
Used for get_delay and set_delay control orders 

del DELA.Y_VER.SION fixed bin int static options (constant) init (1) ; 

del 1 delay_struc aligned based, 
2 version fixed bin, 
2 default fixed bin, 
2 delay like delay; 

del 1 delay based aligned, 
2 vert_nl fixed bin, 
2 horz_nl float bin, 
2 const_tab fixed bin, 
2 var_tab float bin, 
2 backspace fixed bin, 
2 vt ff fixed bin; 
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I Output Flow Control 

I Some terminals cannot accept output as fast as Multics can send it 
I For synchronous lines, this is handled by protocol 
I For asynchronous lines , several modes exist to solve the problem 
I These solutions are not valid for X.25 

I Flow control must be between PAD and terminal 
I No X.25 parameters for this problem 
I All flow control for asynchronous lines is handled in FNP 
I oflow mode 

I Turns on either of the two types of output flow control 
I ETB/ACK output flow control 
I Suspend- Resume output flow control 
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ETB-ACK Output Flow Control Protocol 

Characters 
Sender sent Meaning 

Multics: thisisETB Here's a block of output for you. 

(Silence while Multics waits for OK to resume.) 

Terminal: ACK OK, I can take another block of up to 256 characters. 
Multics: theoutETB Here's a block of output for you. 

(Silence while Multics waits for OK to resume.) 

Terminal: ACK OK, I can take another block of up to 256 characters. 
Multics: putforETB Here's a block of output for you. 

(Silence while Multics waits for OK to resume.) 

Terminal: ACK OK, I can take another block of up to 256 characters, 
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Suspend/Resume Output Flow Control Protocol 



Character 
Sender sent Meaning 

Multics: t Here's a character for you. 

Multics: h Here's a character for you. 

Multics: i Here's a character for you. 

Multics: s Here's a character for you. 

Multics: i Here's a character for you. 

Multics: s Here's a character for you. 

Terminal: X-OFF Wait, I can't handle any more for the moment. 

(Silence while Multics waits for OK to resume.) 

OK, I can handle some more now. 

Here's a character for you. 

Here's a character for you. 

Here's a character for you. 

Here's a character for you. 

Here's a character for you. 

Wait, I can't handle any more for the moment. 

Here's a character for you. 

(Silence while Multics waits for OK to resume.) 



Terminal : 


X-ON 


Multics : 


t 


Multics : 


h 


Multics : 


e 


Multics : 


o 


Multics: 


u 


Terminal : 


X-OFF 


Multics : 


t 



Terminal : 
Multics : 
Multics: 



X-ON 

F 
u 



OK, I can handle some more now. 
Here's a character for you. 
Here's a character for you. 
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output suspend: A S; 

_ _ J~ _ _ , A /-> . 

ouuput_reauiue . v£ , 



Output Flow Control 
Extracts From Terminal Type File 



output_end_of_block: ETX; 
buffer size: 256; 



Extract from flow_control_info.incl.pll 
Used for get_ofc_info and output_flow_control_chars control orders 

del 1 output_flow_control_info aligned based, 
2 flags unaligned, 

3 suspend_resume bit (1) , 

3 block_acknowledge bit (1), 

3 mbz bit (16) , 
2 buffer_size fixed bin (18) unsigned unaligned, 
2 suspend_or_etb_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3) , 
2 resume_or_ack_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3) ; 






f-^O 



/-\ c_V^ Av-^'t _^Vsv- jCOw><^ x 




*/\l 



^ 



^ 









u 



•^ 



9- 



V 



rf«^> C^ 



O' 
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I Input Flow Control 

I Multics normally expects asynchronous lines to send data slowly 

I At typing speed 

I Some terminals and microcomputers can send input to Multics at line 
speed 

I Multics cannot always keep up 

I For synchronous lines, this is handled by protocol 

I For asynchronous lines, several modes exist to solve the problem 

I These solutions are not valid for X.25 

I Flow control must be between PAD and terminal 
I No X.25 parameters for this problem 

I All flow control for asynchronous lines is handled in FNP 
I blk_xfer mode 

I For some terminals that send a screenful of data 

I Data must be bracketed by special characters 

I If read with a get_chars operation, whole screenful is returned 

I Causes hiffffp.r in-mit- hii-F-Fpf.c t-n He alln^at-oH 
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Block Transfer 
Extract From Terminal Type File 



terminal_type : 



f raming_chars : STX ETX; 



Structure for eet framine chars and set framing chars control orders 



del 1 framing_chars aligned, 

2 frame_begin char(l) unaligned, 
2 frame_end char(l) unaligned; 



I iflow mode 

1 Suspend- Resume input flow control 

I Same as used in output flow control 

J 1- second timeout possible 

I Causes bigger input buffers to be allocated 
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Suspend/Resume Input Flow Control Protocol with Timeout 





Character 


Sender 


sent 


Terminal : 


t 


Terminal : 


h 


Terminal : 


i 


Terminal : 


s 


Terminal : 


i 


Terminal : 


s 


Multics : 


X-OFF 



Meaning 

Here's a character for you. 
Here's a character for you. 
Here's a character for you. 
Here's a character for you. 
Here's a character for you. 
Here's a character for you. 
Wait, I can't handle any more for the moment. 



(Silence while Multics waits for OK to resume.) 

OK, I can handle some more now. 

Here's a character for you. 

Here's a character for you. 

Here's a character for you. 

Here's a character for you. 

Here's a character for you. 

Wait, I can't handle any more for the moment. 

Here's a character for you. 

(Silence while Multics waits for OK to resume.) 



Multics : 


X-ON 


Terminal : 


t 


Terminal : 


h 


Terminal : 


e 


Terminal : 


i 


Terminal : 


n 


Multics : 


X-OFF 


Terminal : 


P 



Multics : 



X-ON 



OK, I can handle some more now. 



(Silence for one second) 

Multics: X-ON I repeat, I can handle some more now. 
Terminal: u Here's a character for 'wqu. 
Terminal: t Here's a character for you. 
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Input Flow Control 
Extract From Terminal Type File 



terminal_type : 



input_suspend: S; 
input_re sume : A Q ; 



Extract from flow_control_info.incl.pll 
Used for get_ifc_info and input_flow_control_chars control orders 

del 1 input_flow_control_info aligned based, 
2 suspend_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3) , 
2 resume__seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3) , 
2 timeout bit (1) ; 
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I Parity 

I Normally send even parity, ignore input parity and strip input parity 
bits 

I All parity is handled in FNP 

I 8bit mode 

I Affects input parity 

I Inhibits stripping of parity bit 

I Treat parity bit as 8th data bit and receive any 8 -bit sequence 
I oddp mode 

I Affects output parity 

I Generates odd parity instead of even 
I no_outp mode 

I Affects output parity 

I Generates no parity bits ., 

I If used with rawo any 8 -bit sequence can be sent c 
I Pseudo -modes 
I default 

I erkl , can, A rawi , A rawo , A wake_tbl , esc 
I init 

I All modes off, except 1150 
I force 

I Hide errors in following modes 

I force, replay, polite works on async and X.25 lines 
{ Miscellaneous Orders 
I hangup 

I Sreak connection with terminal 
I interrupt 
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I Send break to terminal 



I get_channel_info . f<.~?) ^ ^* 



i 



i«wc« v ^ __ c il^ ,T , 



C<-~9 -[- o^* ^ t^*-" 



I Can get devx to use in direct hes_ calls ^ r >? 






\&"^ L0- 



I start i _ «7 

< 






I Sends an extra wakeup 

I Should be used by programs that wakeup and do terminal I/O 
I terminal_info 

I Get information such as line speed 
I write_status 

I Find if any buffers waiting to be sent to terminal 
I read_status 

I Find if any input buffers waiting to be read 
I abort 

I Flush input and output buffers 
I resetread 

I Flush input buffers 
I resetwrite 

J Flush output buffers 
I get_event_channel 

I Find out event channel for wakeups 

I Useful if need to wait on more than one channel 
I set_event_channel 

1 Change event channel used 

I Useful if want to use event-call channel instead of event-wait 
channel 



tty_ Modes and Control Orders 
Advanced MCS User Features F86 Page 3-37 



h tty_ attach description 

I tty_ {device} { -control_args} 
I tty_ LINE 

I Attach LINE as slave line 

I LINE can be generic destination 

I tty_ LINE -destination DESTINATION 

I Attach LINE as autocall line with specified phone number or network 
address 

I LINE can be generic destination 
I tty_ -dial_id STR 

I Wait for 'dial STR' on a login line and attach 
I tty_ -login_channel 

J Attach login channel without knowing name 
I -resource STR 

I Ask for line of a certain speed 
I -no_hangup_on_detach/ -hangup_on_detach 

I Default is -hangup_on_detach 
I -suppress_dial_manager 

I Use if process already has line owned or on loan 

I Used by Initializer 

I Used for login channel 

I Used if dial_manager_ calls have already been made 
I -no_block 

I Never go blocked on input or output 
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MCS Ring Internals 

Databases 

I tty_buf 

I Wired, contains most wired data for Ring MCS 

I All information used during interrupt handling must be wired 

J Buffers 

I WTGBs ^\rj TlK^-vJ ( Q "^ ( % l °^ 

I LCT [oej'.ca' C*ma- TVyP'l 

I Size is specified with PARM TTYB card in config deck 

I Default is 6K 

I Too small for average configuration 

I Size requirement can be calculated 

I CC75 Appendix G 

I Meters can show utilization r^br? ^V^tl.^ 

I Header contains meters and pointers to other data within tty_buf 

I LCT 

I Logical Channel Table 

I In tty_buf 

I One entry (LCTE) for each entry in CDT 

I For each FNP, multiplexer, non-multiplexed channel 

I LCTE has pointer to data for FNP, multiplexer, or 
non- multiplexed channel 

I WTCB or fnp_info or multiplexer -specific data 

I For FNP or mpx, this data contains pointers to descendant 
LCTEs 

1 LCTE has pointer to LCTE of its parent multiplexer 

I Index of LCTE in LCT is called devx 
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I LCNT 



I WTCB 



I devx is what is used in hcs_ calls to identify line 

Logical Channel Name Table 

Parallel to LCT 

In tty_area, a paged supervisor segment 

Each entry has names of channel 

Allows conversion of devx into channel name 

Used for error messages 



Wired Terminal Control Block 

5 1 ait J&tt _rrif^ v ^ 
Primary database for non^multiplexed channel 

Database pointer in LCTE of non-multiplexed channel points to it 

In tty_buf 

Data in WTCB used during interrupts, so it must be wired 

1 Event channel for waking up process when input arrives 

Pointers to active input and output buffer chains 

Contains pointer to TCB 

I TCB contains data about channel that is not used at interrupt 
time 

I TCB 

I Terminal Control Block 

I In tty_area, a paged supervisor segment 

I Has pointers to conversion and translation tables 

{ Current and default 

I Bits to indicate modes set 

I tty_tables 

I A paged supervisor segment 
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I Contains tables used during input/output conversion and translation 

I Input translation 

I Output translation 

I Input conversion 

I Output conversion 

I Special 

I Delay 
I Tables are shared among lines (and hence among processes) 
J Often many lines use same tables 
I Reference count tells when table can be freed 
I fnp_inf o 

I In dn355_data, a wired supervisor segment 
I Pointed to by LCTE for FNP 
I Contains pointer to mailbox area for FNP 
I Contains pointer to PCB array for FNP 
I PCBs 

I Physical Channel Blocks 
I In tty_buf 

I Array of PCBs is pointed to by fnp_info 
I Indexed by channel number 
I Has pointer to LCTE of subchannel 
I Pointers to I/O buffer chains for subchannel 
I dn355_mailboxes 

I Contains mailboxes for each FNP 

I Used in FNP<->Multics communication 
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Ring Zero MCS Databases 



j DATANET_MBX | 

I I 

| | submbx | | 

! I ! I 



| | submbx f I 



FNP INFO 



10 



V 



K-- 



TTY_BUF 
HEADER 



I 
I 
2 



j Free | | Free 
•1->| Buffer !-->! Buffer 
I I I 



+- 

I 

I 



3 > 






V 
LCT 


1 


1 1 

--5------I 

1 1 
1 1 


LCTE 
"a" 


1 1 
! 1 
1 1 
1 1 




A 

6 

1 

! 




1 1 
+ >l 

1 I 1 
7 [ I 


LCTE 
"a.hOlO" 


1 1 
i 1 
1 — 
1 1 


! i i 
+ | j 



| Input | 
1 Buffer j 
1 ! 


| Output 
| Buffer 

1 


A 

1 
j Input ] 
| Buffer j 
I ! 


A 

I 
| Output 
j Buffer 

1 


I 
8 


1 

9 



— -11— >l 



WTCB 



12 



TCB 



| Special | 
j Chars Tblj 

I I 



•13- 



| +--14-- 

_V V 

| Special | | Special | 
-> | Chars Tblj --> | Chars Tbl| 



.1 



1) tty_buf.free 

2) tty_buf .lct_ptr 

3) lct.lcnt_ptr 

4 ) f np_inf o . mbx_p tr 

5 ) Icte . data_base_ptr 



6 ) 1 c te . ma j o r_channe l_devx 

7) pcb_array(n) .devx 

8) wtcb.fblock 

9) wtcb.write_first 

10 ) f np_inf o . pcb_array_p tr 



11) Icte . data_base_ptr 

12) wtcb.tcb_ptr 

13) tcb.specialrp 

14) tcb.df_specialrp 
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h Programs 

I tty_write 

I Called via hcs_$tty_write 

I Copies user's output from user ring buffer into buffer in tty_buf 

I May accept only part of user's output 

I User ring program must block, await wakeup and call again 

I Performs output conversion and translation 

I Calls next level of programs (usually fnp_multiplexer) to send data 
on to FNP 

I tty_index 

I Called via hcs_$tty_index, hcs_$tty_order 

I Handles control orders and mode changes 

I Pass on to FNP (via fnp_multiplexer) if order or mode is handled in 
FNP 

I fnp_multiplexer 

I Formats a mailbox and gives it to dn355 
I dn355 

I Manages DIA 

I Sends interrupts to FNP 

I Receives interrupts from FNP 

I Exchanges information with FNP using mailboxes 
I tty_interrupt 

I Called by dn355 for interrupts from FNP- 

I Tells FNP where to put input data 

I Allocates input buffers 

I Sends wakeup to process blocked for input when input is available 

I Touches only wired data, i.e. LCT, WTCB, buffers 
I tty_read 
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I Called via hcs_$tty_read 
I Usually called after wakeup is received 
I Performs input conversion and translation 
I Copies converted data from tty_buf into user ring buffer 
I tty_space_man 

I Utility to handle all allocation/freeing of buffers in tty_buf 
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h Multiplexing 

{ Connections just described between 

I dn355 and tty_interrupt on interrupt side 
I tty_read/write/ index and fnp_multiplexer on call side 
are not always direct 

For multiplexed lines, some intermediate processing is needed 
Adding control information to blocks of data to be transmitted 
Interpreting and removing control information from blocks of data received 
Multiplexing is generalized using cmtv and channel_manager 
cmtv 

I Channel Manager Transfer Vector 
I Is indexed by 

I Type of line (type of LCTE) 

I FNP, X.25 mpx, HASP mpx, non-multiplexed line, etc. 
I Type of operation 

I Read, write, interrupt, control, etc. 
I channeljmanager 

I Is called by each program that needs to pass data up or down a level 
I For instance 

J By tty_write to send data from user down another level towards 

the FNP 

I By dn355 to send data from FNP up another level toward user 

I There are different entrypoints in channel_manager for che different 
types of operation 

I channel_manager looks in LCTE to get type of line 

I Uses type of operation and type of line to look in cmtv to find 
program to call 

I There is also priv_channel_manager, called for privileged operations 
such as loading an FNP 
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LCTE Chaining for Multiplexing 
Non-multiplexed subchannel 



Interrupt- side 

Operations 

11 

11 

V 

dn3 5 5 $ interrup t 

1 
V 






| cmtv(write) : j | 
| fhp_mpx$write | | 


lcte . j 


fnp_info | 


|cmtv( interrupt) j< j "a" 

|dn35 5$ interrupt} channel type) | 
1 1 ! 


data_base_ptr | 




Icte. j pcb_array(n) .devx 

1 1 
1 1 
1 V 


1 

1 

+ 


J cmtv(write) : | | 
| tty_write j j 


lcte . [ 


WTCB j 


j tty_interrupt j channel_type) j 


data_base_ptr j 





J ~/\" 



Call -side 
Operations 
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LCTE Chaining for Multiplexing 
X.25 Subchannel . 



Interrupt- side 

Operations 

II 

II 

V 

dn355$interrupt 



cmtv(write) : 
fnp_mpx$write 

| cmtv( interrupt) 
| dn355$interrupt | 



cmtv(lcte. 
channel_type ) 



Icte. 
maj_devx 



cmtv(write) : | 

x25_mpx$ write j 

. ..| cmtv(lcte, 

cmtv( interrupt) j< 

x25_mpx$intruptj channel_type) 
I 



maj_devx 




1 nra l 



cmtv(write) : 
tty_write 

j cmtv( interrupt) 
tty_interrupt 



cmtv(lcte. 
channel_type ) 



1 v 


| LCTE 
j "a.hli©-" 




data_bas e_p tr 



tty_write 

A 

II 
II 

Call -side 
Operations 



MCS Ring Internals 



Multiplexing 



F86 Page 4-9 



1 DIA Interrupts 
I Submailboxes 
I TIMW 



Multics-FNP Interface 
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FNP Internals 

Programs 

I All work in the FNP is driven by interrupts 

I HS1A 

I Input from a line 

1 Status change for a line 

I DIA 

I Mailbox interrupt from Multics 

I Terminate interrupt from I/O started by FNP 

I Timer 

I No work ever seems to be done directly 

I Everything that needs to be done is put in a queue to be done later 
as time permits 
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FNP WORK SCHEDULING 
MASTER DISPATCHER- -INTERRUPT -DRIVEN 



INTERRUPT 
* 
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FNP WORK SCHEDULING 
SECONDARY DISPATCHER- -QUEUE DRIVEN 
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*********** , __ 

* DIA * * 

* REQUEST * 

* QUEUE 
*********** 



^i*£)lS To^ii v>V D-4 



MISC UTILITIES 



* 
* 
* 
* 
* 
* 
* 
********* 



-+ 



+ + + 

I 

v 
+ + + 

[ CONTROLJTABLES | 

I I 

+ + + 



-+ 
I 
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Three-Word Jump Table ^ - ^V./-'— ~ ^^^ 



Interrupt 
Vector 

tsy 


indir* 

+ — 

1 

! 
• -+ 


5Ct 


Handler 






| addr (handler) | — 


---> 
---> 


ITC at intp time 






1 | addr (handler) | 


Handler 
Code 




2 | addr (handler )| 




3 | addr(handler) | 




4 | addr (handler) | 










5 [ addr (handler) [ 






; 




Interrupt 
Vector 

tsy 


indir« 


JCt 


Three -word 
Jump Table 


tsy 


Handler 


1 addr Chandl e>r} 1 




IC at intp time 

tsy to handler 

ioc/devid/mod 


+ > 

1 + 

"+ i 

1 

< + 

i = 

1 : 
---+ | 

1 
< + 




1 1 


-+ 

1 

! 

1 
1 

i 

1 

1 

1 

+ 


--> 


IC from 3wjt tsyj 


1 | addr (handler) | 
1 1 


Handler [ 
Code 1 


2 1 addWhartHI o-r^ 1 




i i 




3 | addr (handler) | 
1 1 


IC at intp time 
tsv to handler 
ioc/devid/mod 




41 addr (handler - ) 1 

i i 




5 j addr (handler )| 
1 1 




: 


IC at intp time 
tsy to handler 
ioc/devid/mod 






IC at intp time 
tsy to handler J 
ioc/devid/mod | 
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I scheduler (sked) 

I Schedules work to be done 

I sked$invp is the primary interrupt handler. 

I sked$mdisp is the master dispatcher 

I sked$dspqur schedules work for later handling 

I The secondary dispatcher runs work queued by dspqur 

I hsla_man (hsla) 

I Controls HSLAs 

I hsla$hintr handles HSLA. interrupts 

I hsla$hstprc does work queued at interrupt time 

I hsla$hdcw accepts output commands from control tables 

I hsla$hcfg handles configuration changes 

I hsla$hmode handles mode changes 

I hsla$hgeti handles replay and polite modes 

I dia_man (dia) 

I Controls the DIA 

I dia$dterm handles DIA terminate interrupts 

I dia$dmail handles DIA mailbox interrupts 

I dia$dgetwk does work queued at interrupt time 

I dia$denq accepts data to be sent to CS 

I interpreter (intp) 

I Control Tables Interpreter 

I control_tables , etc. 

I Implement the communications protocols 

I utilities (util) 

I Utility subroutines 

I melt 
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I COLTS hardware tests 
| trace (trac) 

I Puts trace information in trace table 
I meters (metr) 

I Collect meters for channel_comm_meters 
I init 

I FNP initialization program 
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a Databases 

I Communications Region 

Global database for FNP 

Pointers to other databases in FNP 
I KM Table 

Used during initialization and to refind HSLA Table to find TIB 



I TIB 



I SFCM 



I HWCM 



Terminal Information Block 

Main per -channel database 

Contains data used by many programs 

Stored in extended memory 

TIB, SFCM and two buffers permanently allocated to channel are stored 
in a 256 -word page 

Page is addressed using page table entry 4177 (addresses 77400-77777) 

Software Communications Region 

Per -channel 

Contains information for HSLA for channel 



Hardware Communications Region 
Per -channel 

Contains control words for HSLA 
Pointer to CCT for channel 

I CCTs are shared, similar to tables in tty_tables 
Pointer to SFCM for channel 

Stored in low- order memory, address known by hardware 
I HSLA Table 
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I Pointed to by IOM table 

I One two -word entry per channel 

I Entry contains pointer to TIB 

I Finding the TIB for a given channel is its main function 

I TIB Table 

I One 2 -word entry per channel 

I Not arranged in any particular order 

I Each entry contains a pointer to TIB and a pointer to outstanding DIA 
requests for channel 

I DIA Requests are stored in low-order memory 

I TIB Table plus these DIA requests make up the DIA Queue 

I Buffers 

I Are mainly allocated in extended memory 

I Addressed using page table entry 4176 (addresses 77000-77377) 

I Free space chained from .crnxe 

I If no free space in extended memory, can use free space in low- order 
memory 

I Normally used for CGTs, DIA. requests, etc. 
I Free space in low- order memory is chained from .crnxa 
1 Buffer Requirements 

I Can be calculated using CC75, Appendix B 

I There are meters to show utilization 
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FNP Databases Excluding I/O Buffers 
(Per-Channel Databases Shown for a.b.205) 



640- -> 



+-.crttb- 




| Free | | Free | | Free | 

-.crnxa->| Space |-->j Space |-->| Space j 

I i I . I I I 



I Free | | Free | | Free | 

.crnxs->| Space |-->| Space |-->| Space | 

I I I I I I 



.criom >j I0M 

I Table 

.crcct+ | 

+14-->| 

+16-->| 

+20- ->I 



1000- ->| HWCM | 
| HSIA | 


2000- ->| HWCM | 
| HSIA 1 | 


3000- ->| HWCM | 
| HSIA 2 | 

3000- ->| j 
+5*16 | | 



h 



+ — + 



+--> 



+5*2 --> 



HSIA Tbl 
HSIA 



HSIA Tbl 
HSIA 1 



HSIA Tbl 
HSIA 2 



- + 



V 



I CCT I | CCT | | CCT | 
| |— ~>| |— ->| | 



1 
-h . baw 1- 

-h.sfcm--+ 

+ >| SFCM 



+-sf.tib*- j 




-t.sfcm*-+ 



i DIA | i DIA | i DIA j 
j Request j >j Request j >j Request j 

I I I ! I I 
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FNP I/O Buffers 



Comm | | Free | | Free | | Free | 
Region j-.crnxe->| Buffers j-->| Buffers |-->| Buffers j 

I ! I I I I I 

I 



| HWCM | 
| |-h.sicO--- 
| |-h.sicl--- 
i j-h.ricO--- 
| |-h.ricl-+ 
I I I 

I I I 

V 

j ICW~ 

I 



-+ 
! 



V 



ICW 



.1 



! 
I 

V 

I ICW i 

I I 



V 

i ICW i 



I Input j | Input | 
I Buffer 1 I I Buffer "2 I 



.1 I. 



O 



| Output | | Output | 
I Buffer 1 I I Buffer -2- I 



I 



.1 I. 



_°_l 



I 



6 



I +---sf.ib1--+ +--sf.ob8---+ 

I 1 I 

+-- sf.ib&--+ | j +--sf.obi.--- 

I I 1 I 

_LI_I_I_ 
+--h.sfcm >| SFCM |< 



+ - 

I 
V 



• t . dep 



i Buffer | | Buffer j | Buffer 
| for DIA i->|for DIA |->|for DIA | 
I I I I I \Vk u *\ Sa° I 




•t.sfcm*-+ 



| Echo | 
---t.echo-->[ Buffer j 

I I 



V 



II I I 

---t.icp--+ | | +--t.olst ---+ 

+--t.ilst--+ j | 

! t . ocur j 

! I I 

V V V 



I Input | | Input | | Input | | Output | | Output | | Output 
| Buffer |->| Buffer |->j Buffer j j Buffer |->| Buffer j->| Buffer 
I 1 I I I I I I I I I 



lk<L 



V^Wr In? $te*A $>\&* r ^' ^ fFPK 
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Start 



420 

440 

450 

475 

500 

640 

776 

1000 

. crept 

. criom 

.crionri-15,* 

.crmod-22 

. crttb 

. crbuf 
(=.crtte) 

77000 

100000 

100000+ 
#lines*400 

. crtrb 



Length 

420 

20 

20 

20 

1 

140 

136 

2 

#hslas*1000 

200 

40 

#hslas*100 

variable 

#lines*2 

variable 

77777 

#lines*400 

variable 



. crmem- 
. crtrb 



FNP MEMORY LAYOUT 

Explanation 

Interrupt Vectors 

Fault Status Words 

Fault Vector 

Mailboxes 

Page Table Address 

LSIA HWCMs 

Communication Region 

Missing Module Code 

HSLA HWCMs 

CPU Page Table 

IOM Table 

HSIA Tables 

Program modules 

TIB Table 

Low memory buffer pool (for TIB extensions, 
CCTs, DIA queue, delay tables) 

Unused Pages 

SFCM/TIB pairs, I/O Buffer pool 

I/O Buffer pool 

Trace Buffer 
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display_fnp_symbols : proc ; 

/* Program to list all the symbols which are understood by debug_fnp */ 
/* Coded 19 August 1980 by Jim Homan */ 

del i fixed bin; 

del ioa_ entry options (variable) ; 

%page ; 

% include debug_f np_data ; 

%page ; 

symbol_tablep - addr (db_fnp_symbols_$db_fnp_symbols_) ; 

call ioa_ ("Symbol Value Length Explanation^/") ; 

do i =- 1 to symbol_table . cnt ; 

exptextp - addrel (symbol_tablep, symbol_table . entry (i) .explain) ; 
call ioa_ (""10a A 10o A 10d V, symbol_table . entry (i).name, 

symbol_table. entry (i) .value, symbol_table . entry (i).len, 
exptext . data) ; 
end; 

end display_f np_symbols ; 
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Communications Region 



Name 


Address 


Length 


crldt 


640 


4 


crbdt 


644 


4 


crbuf 


650 


1 


crmem 


651 


1 


crribf 


652 


1 


criom 


653 


1 


crnhs 


654 


1 


crnls ^ 


655 


1 


crcon 


656 


1 


crmod 


657 


1 


crnxa 


660 


1 


crtra 


661 


1 


crtrb 


662 


1 


crtrc 


663 


1 


crreg 


664 


1 


crttb 


665 


1 


crtte 


666 


1 


crdly 


667 


1 


crver 


670 


2 


crbrk 


672 


1 


crtsw 


673 


1 


crnxs 


674 


1 


crnbs 


675 


1 


erect 


676 


1 


crskd 


677 


1 


cretb 


700 


1 


crept 


701 


1 


crpte 


702 


1 


crtsz 


703 


1 


crmet 


704 


1 


crtdt 


705 


1 


crbtm 


706 


1 


crnxe 


707 


1 


crbpe 


710 


1 


crcpr 


760 


14 



Explanation 

date and time of binding 

date and time of bootloading 

starting address of buffer area 

last location of memory 

number of buffers available 

start of iom table 

number of hsla's configured 

number of lsla's configured 

console enabled flag 

starting address of module chain 

ptr to next available buffer 

trace entry enable mask 

base address of trace table 

next available location in trace table 

disaster fault register storage location 

location of tib table 

location of end of tib table 

head of delay table chain 

mes version number, 4 chars 

addr of breakpoint control table 

if non-zero, tracing will cease 

next free small block 

number of buffers devoted to small space 

address of first cct descriptor 

address of scheduler data block 

list of echo-negotiation bit tables 

address of cpu page table 

address of variable cpu page table entry 

size of trace data buffer 

non-zero if metering enabled 

address of tib for t&d executive channel 

address of time meters for getbuf/frebuf 

next available space in extended memory 

buffer paging window table entry 

copyright notice 
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TIB 



Name 


Address 


Length 


t.stat 





1 


t.flg 


1 


1 


t.flg2 


2 


1 


t.cur 


3 


1 


t.line 


4 


1 


t.icp 


5 


1 


t.ilst 


6 


1 


t . icpl 


7 


1 


t.icch 


10 


1 


t.elnk 


11 


1 


t.rcp 


11 


1 


t.ocp 


12 


1 


t . ocur 


13 


1 


t.olst 


14 


1 


t . occh 


15 


1 


t . ocnt 


16 


1 


t.type 


17 


1 


t.time 


20 


2 


t . reta 


22 


1 


t . dcwa 


23 


1 


t . dcwl 


24 


1 


t . echo 


25 


1 


t.dcp 


26 


1 


t.dlst 


27 


1 


t.ftse 


30 


1 


t.sfcm 


30 


1 


t . bent 


31 


1 


t.brkp 


32 


1 


t.pos 


33 


1 


t . char 


34 


1 


t . ecch 


34 


1 


t . cntr 


35 


1 


t.flg3 


36 


1 


t.dtp 


37 


1 


t.frmc 


40 


1 


t.dcpl 


41 


1 


t.scll 


42 


1 

J. 


t . snee 


43 


1 


t . entp 


44 


1 


t.ifch 


45 


1 


t . of ch 


46 


1 


t . omct 


47 


1 


t.itim 


50 


2 


t.metr 


52 


1 


t.abfO 


53 


1 


t.abfl 


54 


1 



Explanation 

holds current line status 

flag word 

second word of flags 

current address in control table 

10 bit line number 

first buffer in input chain 

last buffer in input chain 

count of buffers in icp chain 

address of next input character 

link to tib extension 

replay chain pointer (share t.elnk) 

addr of output chain from cs 

addr of current output buffer 

addr of last buffer in output chain 

addr of next output character 

count of buffers in t.ocur 

line type 

time at which next timeout will occur 

return address from calsub 

addr of dew list to 'execute' 

length of dew list 

echo buffer address 

addr of message chain for cs 

last buffer in messge chain for cs 

first time slot entry in lsla table 

pointer to sfcm for hsla lines 

counting temporary 

pointer to current break list 

current carriage position 

pending line control char (lsla only) 

address of current echo char (hsla only) 

counter for control tables 

third word of flags 

pointer to delay table for this line 

framing chars (2 chars) 

number of buffers in dep chain 

screenline length left, for echo neg. 

Echo negotiation sync ctr. 

Echo negotiation break table ptr 

input flow control characters 

output flow control characters 

output message count (for flow control) 

time of last call to inproc (2 words) 

address of metering area 

absolute address of first permanent buffer 

absolute address of first permanent buffer 
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Flags for tib.flg 



Name 


Address 


Length 


tfosus 


-400000 


1 


tfecpx 


200000 


1 


tfisus 


100000 


1 


tfeotx 


40000 


1 


tfauto 


20000 


1 


tfwabt 


10000 


1 


tftbec 


4000 


1 


tfcrec 


2000 


1 


tflfec 


1000 


1 


tfctrl 


400 


1 


tfquit 


200 


1 


tflisn 


100 


1 


tfhang 


40 


1 


tfprtr 


20 


1 


tfkybd 


10 


1 


tffdpx 


4 


1 


tfbel 


2 


1 


tfwrit 


1 


1 


tfdlup 


20 


1 


Name 


Address 


j 
Length 


tfpfnl 


-400000 


1 


tfsftr 


200000 


1 


tffip 


100000 


1 


tffrmi 


40000 


1 


tfmrcv 


20000 


1 


tfcrcv 


10000 


1 


tfblak 


4000 


1 


tfplit 


2000 


1 


tfrpon 


1000 


1 


tfrply 


400 


1 


tfupsf 


200 


1 


tfofc 


100 


1 


tfifc 


40 


1 


tfacu 


20 


1 


tfrabt 


10 


1 


tfercv 


4 


1 


tfdild 


2 


1 


tfxhld 


1 


1 



Explanation 

output suspended 

echoplex mode 

input suspended 

eot expected from 2741 

this is hsla autobaud line 

do write abort 

do space echo on tab 

do cr echo on If 

do If echo on cr 

do kybd/printer addressing 

send nl on line break 

answer the phone 

hangup this line 

printer addressed 

keyboard addressed 

full duplex mode 

send bell as next echoed character 

output chain present 

line is on dialup modem 

Flags for tib.flg2 

Explanation 

line is in prefixnl mode 

terminal is shifting device 

frame in progress 

frame mode 

'message' receive mode 

'control' receive mode 

asynchronous block acknowledgement 

polite mode 

replay is occurring now 

replay mode 

terminal is upshif ted now 

output flow control mode 

input flow control mode 

do dial out 

do read abort 

enter receive mode 

terminal is dialed up 

hold transmit on 
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Name 
tfmask 
tfabfl 
tforp 
tfsoip 
tfabfO 
tfoddp 
tf8out 
tf8in 
tfsked 
tfbral 
tfecho 
tfkpar 
tfitim 
tfbkpt 



Flags for tib.flg3 

Address Length Explanation 

20000 1 channel has been masked for excessive interrupts 

10000 1 t.abfl available 

4000 1 output resume pending (waiting until tro) 

2000 1 suspension of output in progress 

1000 1 t.afbO available 

400 1 odd parity 

200 1 don't strip output parity 

100 1 don't strip input parity 

40 1 input timeout routine scheduled 

20 1 break on all characters 

10 1 echoing has priority over output (Isla) 

4 1 keep parity bits' 

2 1 timeout if input stops 

1 1 line is stopped at breakpoint 



Flags for tib.stat 



Name 
tsfcrq 
tsfrts 
tsftre 
tsfsxt 
tsfdtr 
tsfbrk 
tsfxmt 
tsfrcv 
tsftrm 
tsfmrk 
tsfst 
tsfsrc 
tsfdsr 
tsfcts 
tsfcd 



Address 


Length 


Explanation 


20000 


1 


acu call request 


10000 


1 


request to send 


4000 


1 


tally runout enable (hdlc) 


4000 


1 


supervisory transmit 


2000 


1 


data terminal ready 


1000 


1 


send line break 


400 


1 


transmit mode 


200 


1 


receive mode 


100 


1 


send terminate status 


40 


1 


send marker status 


20 


1 


store status 


10 


1 


supervisory receive 


4 


1 


data set ready 


2 


1 


clear to send 


1 


1 


carrier detect 
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SFGM 



Name 


Address 


Length 


sf .hem 





1 


sf .nxa 


1 


1 


sf .nxp 


2 


1 


sf.tly 


3 


1 


sf .tib 


4 


1 


sf.flg 


5 


1 


sf.ibO 


6 


1 


sf.ibl 


7 


1 


sf .obO 


10 


1 


sf.obl 


11 


1 


sf .pew 


12 


1 


sf .cct 


13 


1 


sf .ret 


14 


1 


sf .hsl 


15 


1 


sf .bsz 


16 


1 


sf.fbs 


17 


1 


sf .mms 


20 


1 


sf .csz 


20 


1 


sf .rms 


21 


1 


sf .nic 


21 


1 


sf .noc 


22 


1 


sf .ssl 


23 


1 


sf .cfg 


24 


2 


sf .sta 


26 


12 


sf .waq 


42 


40 



Explanation 

addr of hwcm 

addr of next available queue entry 

addr of next queue entry to process 

tally of status queue 

addr of tib for this line 

flag word 

pointer to input buffer 1 

pointer to input buffer 2 

pointer to output buffer 1 

pointer to output buffer 2 

current pew 2nd word 

cct addr for this line, if non-zero 

repeat count for status queue overflows 

address of hsla table entry for this line 

max buffer size 

buffer size to be used during frame input 

maximum synchronous message size 

current asynchronous buffer size 

remaining unallocated message length 

char, address of next asynchronous input char 

char address of next asynchronous output char 

number of entries in software status queue 

2 words for config pew 

hardware status q, sicw here 

wrap around queue, software status q 
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Flags for sf.flg 



Name 
sffhdl 


Address 
-400000 


Length 
1 


sffssb 


200000 


1 


sffnib 


100000 


1 


sffofr 


40000 


1 


sffmsp 
sffsyn 
sffsqo 
sffbsc 


20000 

10000 

4000 

2000 


1 
1 
1 
1 


sffstp 
sffdct 


400 
200 


1 
1 


sffech 


100 


1 


sffebd 


40 


1 


sffsct 


20 


1 


sffisc 


10 


1 


sffcoi 


4 


1 


sffcii 


2 


1 


sffskd 


1 


1 



Explanation 

uses hdlc channel board 

copied alternate buffer back to output chain 

need to allocate new input buffer (s) 

old setting of tffrmi (lines up on tffrmi) 

marker status pending 

any synchronous line type 

status queue overflow pending 

binary synchronous device 

stop channel, rxmit done 

dynamic (sharable) cct in use for channel 

tab, cr, If echo going on now 

ebcdic data code on this line 

short cct flag 

inactive subchannel flag 

on if alternate output icw is active 

on if alternate input icw is active 

status processor is scheduled 
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HWCM 



Name 
h.ricO 
h.ricl 


Address 

2 


Length 
2 
2 


Explanation 
primary receive icw 
alternate receive icw 


h.sicO 
h.sicl 


4 

6 


2 
2 


primary send icw 
alternate send icw 


h.baw 


10 


1 


base address word 


h.sfcm 
h.mask 
h . aicw 


11 
12 
14 


1 
2 
2 


software coram, region address 
mask register 
active status icw 


h . cnf g 


16 


2 


configuration status 
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FNP Line Meters 



Name 


Address 


Length 


m.dql 





2 


m.dqu 


2 


2 


m.nst 


4 


2 


m.nsu 


6 


2 


m.over 


10 


1 


m.par 


11 


1 


m.ssqo 


12 


1 


m.hsqo 


13 


1 


m . inaf 


14 


1 


m.cql 


15 


1 


m.exh 


16 


2 


m.xte 


20 


1 


m.leng 


22 


1 


m.prex 


22 


2 


m.ebof 


24 


2 


m.quit 


26 


1 


m.asyl 


30 


1 


m.nim 


22 


2 


m.iml 


24 


2 


m.mini 


26 


1 


m.maxi 


27 


1 


m.nom 


30 


2 


m.oml 


32 


2 


m.mino 


34 


1 


m.maxo 


35 


1 


m.cntl 


36 


2 


m . cnt2 


40 


2 


m . cnt3 


42 


2 


m.cnt4 


44 


2 


m.cnt5 


46 


2 


m.cnt6 


50 


2 


m . cnt7 


52 


2 


m.cnt8 


54 


2 


m.synl 


56 


1 



Explanation 

cumulative length of dia request queue 

updates of m.dql 

cumulative no. of pending status 

updates of m.nst 

output overlaps 

parity errors 

software status queue overflows 

hardware status queue overflows 

input allocation failures 

current length of dia request queue 

exhaust status 

software xte status 

length of common meters (must be even) 

pre -exhaust status 

echo buffer overflows 

bell-quits 

total length of asynchronous meters 

number of input messages 

cumulative length of input 

minimum length of input message 

maximum length of input message 

number of output messages 

cumulative length of output 

minimum length of output message 

maximum length of output message 

first type of counter 

second type of counter 

third type of counter 

fourth f.vil(> o-F rnnnfor 

fifth type of counter 

sixth type of counter 

seventh type of counter 

eighth type of counter 

total length of synchronous meters 
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display_cdt 


at 515 |2460 






m_use: ^o r 


iPfaft'*" 






1 (hung up) 


name: 




a.h006 


Multiplexer data: 






service_type : 




1 (active) 


mpx_type : 




11 (x25) 


state : 




4 (up) 


initial load: 




02/09/84 1533.7 hfh Thu 


last load: 




02/20/84 1730.2 hfh Mon 


last crash: 




02/20/84 1601.2 hfh Mon 


load started: 




02/20/84 1730.2 hfh Mon 


flags. go: 




1 


flags . listening: 




1 


current_service_ 


.type: 


1 (active) 


current_mpx_type 


» • 


11 (x25) 


n_bootloads : 




11 


last_tbf : 




293 


comment : 




X.25 major channel 


charge_type : 




(none) 


service_type : 




8 (multiplexer) 


current_service_type : 


8 (multiplexer) 


dim: 




1 (tty) 


line_type: 




17 (X25LAP) 


terminal_type : 




X25 TRANSPAC 


baud_rate : 




1200 


f np_no : 




1 (a) 


event : 




000330011502407777000673 


tra_vec : 




() 


count : 




o 


twx: 







state: 




o () 


current_terminal_ 


type: 




cur_line_type : 




(none) 


tty_id_code : 






process : 




77777 |1 


next_channel : 







n_dialups : 







n_logins : 







dialed_up_time : 




hrs mins sees. 


dialup_time : 




never 


recent_wakeup_count : 





recent_wakeup_time : 


never 
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CDTE at 51512620 



display_cdt 



n.n_use: 

name: 

comment : 

charge_type : 

service_type : 

current_service_type : 

dim: 

line_type : 

terminal_type : 

baud_rate : 

f np_no : 

event : 

tra_vec : 

count : 

twx: 

state: 

current_terminal_type : 

cur_line_type : 

tty_id_code : 

process : 

next_channel: 

n_dialups : 

n_logins : 

dialed_up_time : 

dialup_time : 

recent_wakeup_count : 

recent_wakeup_time : 



1 (hung up) 

a.h006.d01 

X.25 dial_out sub -channel 

(none) 

6 (dial out) 
6 (dial out) 

1 (tty) 
(none) 

300 

() 

000470002046407777000151 
18 (wait_slave_request) 


77 

1 (hung up) 

(none) 

none 

77777 1 1 



1649 _. , a 

1208 t~*Y nf ' ™"' f fi "* 

210 hrs 58 mins 37 sees. 

02/20/84 1623.0 hfh Mon 

1 

02/20/84 1730.2 hfh Mon 
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display_cdt 


at 515 |3560 




in_use: 


5 (logged in & proc) 


name: 


a.h006.001 


comment : 


X.25 login sub-channel 


charge_type : 


(none) 


service_type : 


1 (login) 


current_service_type : 


1 (login) 


dim: 


1 (tty) 


line_type: 


(none) 


terminal_type : 


ASGII CRT 


baud_rate : 


1200 


f np_no : 


o () 


flags . attributes : 


dont read answerback , check acs; 


event : 


000330011356407777000132 


tra_vec : 


8 (wait logout sig) 


count: 


1 


twx: 


62 


state: 


5 (dialed up) 


current_terminal_type : 


ASGII GAPS 


cur_line_type : 


1 (ASCII) 


tty_id_code : 


none 


process: 


366 |1330 


next_channel : 





n_dialups : 


2788 


n_logins : 


2180 


dialed_up_time : 


886 hrs 32 mins 32 sees. 


dialup_time : 


02/20/84 1801.3 hfh Mon 


recent_wakeup count: 


2 


recent_wakeup_time : 


02/20/84 1801.6 hfh Moti 
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interrupt_meters 



Total metering time 0:10:19 



IOM Ch 



Int Avg Time % CPU Name 



A 6. 


1 


1.795 


0.00 


IOM A special 


A 8. 


1417 


0.552 


0.13 


dska 


A 9. 


10 


0.457 


0.00 


dska 


A 12. 


90 


0.563 


0.01 


dskc 


A 14. 


174 


0.531 


0.01 


dska 


A 16. 


2579 


0.545 


0.23 


dskb 


A 17. 


60 


0.495 


0.00 


dskb 


A 18. 


324 


0.579 


0.03 


dskd 


A 20. 


2825 


0.570 


0.26 


dskd 


A 22. 


418 


0.481 


0.03 


dskb 


A 23. 


1 


0.276 


0.00 


dskb 


A 26. 


9 


1.237 


0.00 


prta 


A 28. 


7748 
15656 


2.732 
1.632 


3.42 
4.13 


f np a 

***'■'- »>s. \r ft*— i 


Chan 


^ h % 


Ovhd 


15605 


0.159 


0.40 




Total 


15605 


1.796 


4.53 





\V\ ) 



e> cuf)^ 
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COf 



£ 7^r^ for *'> 



/ fioJ 



>otK 



V 






C<?/^ M<?7e4S 



sy s tem_comm_me ter s 



Total metering time 0:10:03 



ncT 






THROUGHPUT 

Total characters input 
Total characters output 
Average length of input 
Average length of output 
Input characters preconverted 



before conversion after conversion ratio 
5,041 4,705 0.93 

153,567 123,256 0.80 

5.1 characters 
73.3 characters 

(0.0% of total) 



Number of calls 
Average time per call 
Average chars, processed 
Average chars, per msec. 



CHANNEL INTERRUPTS 

software "interrupts" 
average time (msec . ) 



TTY BUF SPACE MANAGEMENT 



read 


write 


1,436 


2,495 


2.13 msec. 


5.09 msec 


3.5 


61.6 


1.7 


12.1 



fi roT i~7-"«s7.kO 



input 

3,243 
2.45 



output 
3,155 
1.02 



other 

113 
2.36 



total 

6,511 
1.76 






Total size of buffer pool 19,368 words 
Number of channels configured 191 
Number of multiplexed channels 18 

% of buffer dooI in use current averacre 

input 8.3 8.4 

output 13 . 8 13 . 6 

control structures 51.1 51.2 



total 



73.2 



73.2 



SU.M fit i*3S Ta*i#i 



Smallest amount nd free space ever 2,594 words (13% of buffer'pooT) - ''?*'!/'/ ^ 6 ' ,$h« 



allocate 
Number of calls 6,755 

Average time per call (msec . ) 0.5 
% of total CPU 0.6 

Calls requiring loop on tty_buf lock 
average time spent looping on lock 
Number of allocation failures 



free 

5,894 

0.5 

0.5 



total 

12 , 649 
0.5 
1.0 



(0.00% of total) 
No data. msec. (0.00% of total CPU) 
(0.00% of attempts) 



CHANNEL LOCK CONTENTION 



(V/cH w^PftSTv^ 



Number of calls to tty_lock 
Times channel lock found locked 
Average time spent waiting for lock 
Maximum time spent waiting for lock 



12,963 

554 (4% of attempts) 
7,93 msec. 
3675.17 msec. 
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Interrupts queued because channel locked 

for ViApo v BMC$ 



553 (8.5% of interrupts) 



ECHO NEGOTIATION 

Average time of transaction 
Chars, echoed by supervisor 
Chars, echoed by FNPs 



ABNORMAL EVENTS 

Input restarts 

Output restarts 
_ Output space overflows 
( "needs_space" calls 



1.7 msec. 



389 ( 7.72% of input chars) "} f(M*3 p 
353 ( 7.00% of input chars)_5 e~«*S fX>2< 



(0.00% of read calls) 
(0.00% of write calls) 
(0.00% of write calls) 




6 ^ P'W £>, 



CU«Ot v-vr*cs 



■^ . 



MCS Metering 



F86 Page 7-7 



channel comm meters 



Total metering time 78:15:27 



FNP has been up for 

Number of channels configured 

Average number dialed up 

FNP idle 

Idle at peak load 



Characters transmitted 
Characters per second 



78:15:25 




73 




54.2 




67.0% 




0.0% 


sw~\ fyt \ei/f\&tc 


Input 


Output 


7,941,871 


38,672,473 


28 


137 



US£ S/1^4, 



\h 



Abnormal DIA status [ p 

Memory EDAC errors - n?? can %)jSTi^J \y 

<Sj C t-,C>cA f~^*0ry 
Memory size 64K 

Total available buffer pool 17,888 words » 
Avg. amount of free space 2,448 words Juli^^t, 
Average % of buffer pool available -13.7 ' ' 
Number of buffer allocations 3,245,838 

Number of buffers preallocated 900,660 ( 27.8% of allocations) 
Used preallocated buffer 900,656 

No preallocated buffer available 126 i *\ i &u \ 

Buffer allocation failures - v**-t«1fis 6«U <?w^ > S /2g 0. 

Output restricted by space ^ 



Number of interrupts from this FNP 1 996 459 
Avg. time/ interrupt (ms) 3.3 

% of total CPU time 2.3 



Mailbox transactions: 
Input data 
Output data 
Input control 
Output control 



756,349 
557,909 
563,976 
122,001 



Total 



2,000,235 



Average inbound mailboxes in use 
Average outbound mailboxes in use 
Maximum outbound mailboxes in use 
No outbound mailbox available 
Input rejects 

% of input transactions rejected 
Total metering time 78:15:30 — ^ 



0.2 
1.0 
3 

56 ' 638 , tt c P 
0.00 



T^b^r 
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channel coram meters 



a.hOOO 



Total characters input 3,471 

Total characters output 874,287 

Average length of input 5.0 

Average length of output 60.9 



Number of calls 

Average time per call (msec . ) 

Average chars, processed per call 

Number of software interrupts 10,891 

Average time per interrupt (msec . ) 1.2 



nversion 


after conversion ratio 




3,274 


0.94 




1,243,897 


1.42 




4.7 






86.6 




read 


write 


control total 


690 


14,361 


98 15,149 


3.2 


8.6 


36.6 8.6 


. 5.0 


60.9 





Effective speed (cps) 

Output overlaps in FNP 

Average length of DIA request queue 

Exhaust status 

Software transfer timing error 

Pre-exhaust status 

Bell/quits 

Echo buffer overflows 

Parity errors 



Avg. number of pending status events 
Software status queue overflows 
Hardware status queue overflows 
Input buffer allocation failures 



output 
0.0 







o.6 4"© ^oH *? s * r? r rr I!* 7u i,.l 

'0 

CoU/Jl pl(oCt>><> fc^ffcrj Gfilf)^ S?s>os 






& {{ (Qu.]f ^ ASyAc 
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channel comm meters 



a.h006 



Messages transmitted 
Minimum message length 
Maximum message length 
Average message length 

Frames dumped: 
Frames retransmitted: 
Receiver reset request: 
Transmitter reset: 
Frame check errors: 
Frame aborts received: 



input 

226,489 

2 

133 

5.19 



output 

178,924 

2 

133 

25.25 



413 

4 





46 

35 



-/WhO 












p 7i, e ^« 



/uf H 



< <3i 



Output overlaps in FNP 37,741 

Average length of DIA request queue 1.5 

Exhaust status 19 

Software transfer timing error 
Parity errors 

Avg. number of pending status events 1.8 

Software status queue overflows 

Hardware status queue overflows 

Input buffer allocation failures 
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channel comm meters 



a.h008 



Idle time 



42.19% 



Blocks NAKed 
Transmission timeouts 
NAKs for DIA backlog 
All transmission suspended 
Blocks transmitted 
Records transmitted 

Average records per block 

Duplicate input blocks 
Output reprocessing 
Blocks reprocessed 



Messages transmitted 
Minimum message length 
Maximum message length 
Average message length *B 



Output overlaps in FNP 1,522 

Average length of DIA request queue 0.5 



Input 
2 


Output 
68 





8 


68 



N/A 



4,812 


7 , 042 


43,204 


69 


8.98 


0.01 


106 














input 
4,812 


output 
7,042 


8 


8 


397 


398 


344.85 


8.09 



Exhaust status 

Software transfer timing error 

Parity errors 




2 




Avg. number of pending status events 0.8 

Software status queue overflows 

Hardware status queue overflows 

Input buffer allocation failures 
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f)icQ 



for 



Allele S Cc\ /-> 



channel comm meters -sum 



Total metering time 78:15:36 
cps cpsi cpso iotxXsbepQqa 



120 


120 
120 

(a.iA ( 

^ 48S 
480 
480 
480 
480 
480 


480 
480 
480 
480 
480 
480 

480 
480 
480 
480 
480 
480 



No data. No data. 
No data. No data. 

0.00 0.11 

0.00 0.02 
No data. No data. 
No data. No data. 
No data. No data. 

1.17 17.76 

0.01 0.10 

0.09 3.70 

0.02 0.29 

0.04 2.24 

0.01 0.65 
No data. No data. 
No data. No data. 



i t X 
io s 



0.39 
0.18 
0.66 
0.00 

0.14 
0.05 

No data 
0.04 
0.08 
0.01 
0.21 
0.01 
0.03 



xX e Qq 



0.03 
2.06 
11.58 
0.12 
9.32 
1.34 

No data, iot 
0.84 
0.97 
0.45 
7.07 
1.56 
1.53 



err ABE name 












78 












224 








a E 
a 

a E 
a 
s 

s 
s 

a E 
a E 
a E 
a E 



a 
a 
s 
s 
a 
a 
a 
a 
a 
a 
130 
a 
a 
a 
a 
a 
a 











a.hOOO 
a.hOOl 
a.h002 
a.h003 
a.h006 
a.hOOS 
a.h009 
a.hOlO 
a.hOll 
a.h012 
a.h013 
a.h014 
a.h015 
a.h016 
a.h017 
a.h018 
a.h019 
a.h020 
a.h021 
a.h022 
a.h023 

a.h025 
a.h026 
a.h027 
a.h028 
a.h029 
a.h030 
a.h031 



user 

Initializer 

Initializer 



Weber 

Initializer 

Initializer 

Initializer 

Initializer 

Initializer 

Initializer Jd;c K 1 ' ^ < 

Larmat 

Initializer 

Initializer 

Initializer 
Raich 



i: Invalid input messsage 

o: Output message restransmitted 

t: timeout waiting for acknowledge 

x: pre -exhaust status 

X: exhaust status 

s: software transfer timing error 

b : bell/quit 

e: echo buffer overflow 

p: parity error 

Q: software status queue overflow 

q: hardware status queue overflow 

a: input buffer allocation failure 

A: Asynchronous channel 

B: Synchronous channel 

E: Echoplex mode 
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display_fnp_idle 



- k'.s^oojir*. 



%busy 10 20 30 40 50 

I ! ! ! ! ! 

07/13/84 1545. A 

1546 . A 

1547. A 

1548. A 

1549. A 

1550. A 

1551. A 

1552. A 

1553. A 

£WsT ^ ^ >f _ fn/>. 'Ma *^ 
display_fnp_idle -sum 

FNP a idle time from 07/13/84 1545.2 to 1554.2: 81.3% 
Busiest sample interval: 

07/13/84 1546.2 to 1547.2: 76.8% idle A>o4*fl f 
Busiest single sample: 07/13/84 1554.2: 0.0% idle 
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MGS Debugging 



FNP Problems/Dumps 
I >scl>fnp_crash_notify.ec 
I dump management 
I debug_fnp 



FNP Problems/Dumps 
MGS Debugging F86 Page 8-1 



o °" ^<\ 



debug_fnp example 
db_fnp 

Dump in >udd>SysAdmin>Homan>fnp. a. 011084. 1126, version 6.5d Hi5>f ~T*$( 1^ nT/V 

illegal opcode fault at 46355 (util|6145 s )_^, ( ^ , J?'T~ t-. t/Tf ^ 
utilities : tried to free space already free f 7" 

^ K"^ &ur zR*s^ m 

i FTw*/? co«p. 9U ^ jUs$J*~\? (o^lJ\^^ /T ewfr/ $>p -into 

13400 10/15/82 

17060 01/11/83 

26342 12/01/82 

27250 07/07/83 

40210 12/01/82 

46740 09/23/82 

47400 09/23/82 

54210 09/23/82 

x25tbs 56142 02/01/83 

meters 66112 09/23/82 

regs \A*ifvPi eP £"^ *Z*jJh2£ 

ic 046355 (util|6145) .rt/UKNe^ C ^-"/Vf 

aq 137400 000040 

ir 520077 (zero, carry, interrupt inhibit) !«•«/•" taT*/* ft^.jTfr 

xl 077340 (init|11034) 

x2 004176 

x3 077000 (init|10474) 

er 777700 *, 

et 776700 f\J§KP\/\( hf^C 



map 

sked 

intp 

ctrl 

dia 

melt 

hsla 

util 

trac 

bsc 

hasp 



-bstat 



Vv 



jf«vr xT*->^5 I oaks /fT \ i' (3-ls * -i /}>! L/wj 



tat Dof^fv.'- xro-ru^ looks fit* i 1 1>^ * ^ /9'.' Lrifj 

571 free f«^ ciJ jtF**ir G^P^r ^,^ e (3a >W jjMO^i) b0> IT & w**fc 
12 small space /" ^ 

LINE 



a.hOlO 
a.h015 
a.h021 



INPUT 

1 

1 
i 



DIA 








OUTPUT TOTAL 









1 
1 
1 



\o~ &- fife 4s ca^s. &tu/Q#;i 
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a.hll2 





a.hll4 


4 


a.hll5 


1 









3 





Pur pvfPev 



3 

4 
1 



0)90- 9^**S **>TCr.T:<x f 



TOTAL 






3 11 



Atf 






y^ 



To Je*1 ,f i 

line. 



print_trace -50 

(662566 op block at 53024 (bsc|3424), type - 060 (clrlcf) 
662567 op block at 53027 (bsc|3427), type = 037 (retsub) 
662567 op block at 54376 (hasp | 166), type - 061 (tstlcf) 
662570 op block at 54427 (hasp j 217), type = 033 (dumpin) 

662570 op block at 54430 (hasp j 220), type - 056 (tstlcl) 

662571 op block at 54370 (hasp | 160), type = 072 (setinrv) 

662572 op block at 54372 (hasp j 162), type - 005 (dcwlst) 

662572 hsla dew processor, tib 122562, list 54373 (hasp 1 163), len 01 5>mJ M». Cc^^^'J 
662575 hsla pcw,, \fclb 122562., pew 211000 000460 To YiS^A, /<*>*,, 



HSU, 



662576 op block at 54374 (hasp | 164), type - 036 (calsub) 

662577 hsla interrupt, 3wjt - 362004 (ch=7 dv^2subch=10 mod=4»^- ! ^ // °^ 

662600 op block at 52476 (bsc|3076), type ^OF0-7^1cTTY , r^A J „ ( K t U^\ 

662600 op block at 52501 (bsc|3101), type = 060 (clrlcf) ypWA*ff\K' t '* r ' J 

662601 op block at 52504 (bsc|3104), type = 061 (tstlcf) / \lrA(T I f r <"^ ^U 

662601 op block at 52510 (bsc|3110), type - 061 (tstlcf) I j^S"'J /M 

662602 op block at 52514 (bsc|3114), type - 003 (wait) / J_ 

662602 hsla status, tib 122562, status 400000 40446^^?=**^^ -~^^3**g T t 
662721 hsla interrupt, 3wjt - 363004^ (ch=7^dv^2 



r\ 



&R 



662722 hsla status, tib 123512, status 420200 702060 

662723 istat: tib at 123512, t.cur - 16367 (ctrl|2767), status 000407 

662724 op block at 16413 (ctrl|3013), type - 004 (status) 

662724 op block at 16036 (ctrl|2436), type-- 036 (calsub) 

662725 op block at 17034 (ctrl|3434), type - 005 (dcwlst) 






-■- v 



1 ?, 



662726 hsla pew, tib 123512, pew 211400 000060 

662727 op block at 17036 (ctrl|3436), type - 006 (setime) 
662727 hsla interrupt, 3wjt - 363004 (ch=7 dv=2 subch=14 mod=-4) 

662731 op block at 17040 (ctrl|3440), type - 003 (wait) 

662732 hsla status, tib 123512, status 420000 700060 

662732 istat: tib at 123512, t.cur - 17040 (ctrl|3440), status 000047 

662733 op block at 17044 (ctrl|3444), type = 004 (status) 

662733 op block at 17050 (ctrl|3450), type - 037 (retsub) 

662734 op block at 16040 (ctrl|2440), type = 052 (setcct) 

662735 op block at 16042 (ctrl|2442), type - 011 (clrflg) 

662735 op block at 16045 (ctrl|2445), type - 017 (sendin) 

662736 op block at 16046 (ctrl|2446), type - 076 (setfld) 
662736 op block at 16051 (ctrl|2451), type - 014 (signal) 
662740 new entry in dia i/o queue at 067176 : opcode 113 (brkcon) 

662740 op block at 16053 (ctrl|2453), type = 012 (tstflg) 

662741 op block at 16064 (ctrl|2464), type = 013 (dmpout) 



r-^> 



■explain .crldt;d .crldt 
".crldt" = date and time of binding 
00640 000000 112155 200407 431126 09/29/83 
explain .crbdt;d .crbdt 



C 40 f » r 1^'rte 



1746.7 hfe Thu 




ocft 



s»a cu n p 



- a 
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".crbdt" — date and time of bootloading 

00644 000000 112346 660120 236056 01/04/84 1050.2 hfe Wed 

explain . crbuf ; d . crbuf 

".crbuf" = starting address of buffer area 

00650 066476 
explain . crmem ; d . crmem 

" . crmem" = last location of memory 

00651 177777 
explain . crribf ; d . crnbf 

".crribf" = number of buffers available (, „ „ < # f/vnK 

00652 001073^==^— ftsM {Of J ,S«* f C 0" Cttob- s V+W 
explain .criom;d .crioni~^ — --— __^^ fP* ^ orf~ 
".criom" - start of iom table ^^~~— --— -_-r ~)t c ^offC^S f(o<^ iiS)+ 

00653 004200 V*- ^ , 
explain .crnhs;d .crnhs 

".crnhs" = number of hsla's configured 

00654 000002 
explain . crnls ; d . cmls 

".crnls" - number of Isla's configured 

00655 000000 
explain . crcon; d .crcon 

" . crcon" — console enabled flag 

00656 000000 
explain .crmod;d .crmod 

".crmod" = starting address of module chain 

00657 004562 ^-^^ ^^ .^-.^ jl' f 15> *? tl**T Q<** r 
explain .crnxa;bufc . crnxa J *^_/--'V ' Sq cRruK?\ Ce^°< : ^^ C 7-S 0Q 
" . crnxa" = ptr to next available buffer 

67300 <j67440, v 000040 > 000000 000000 000000 007000 007000 000000 7 . 

67310 OOOfidO OOObeo loOOOOC 1 000000 000000 000000 000000 000000 

67330 =_V^^<j.^t pn(//«T5 n ~ &•* 0? v^/lfl^ 

67440 ^067540 000040 000000 000000 000000 000000 000000 000000 7' 

67450 j 000000 000000 000000 000000 000000 000000 000000 000000 

67470 J - 

67540 000000 007240 000000 000000 000000 000000 000000 000000 

67550 000000 000000 000000 000000 000000 000000 000000 000000 

67570 - 

explain .crtra;d .crtra 

n . crtra" - trace entry enable mask 

00661 317777 
explain .crtrb;d .crtrb 

".crtrb" = base address of trace table 

00662 174000 
explain .crtrc;d .crtrc 

".crtrc" = next available location in trace table 

00663 177536 
explain . crreg ; d . crreg 

".crreg" = disaster fault register storage location 

00664 040522 
explain .crttb;d .crttb 
".crttb" = location of tib table 

00665 066316 
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explain .crtte;d .crtte 

".crtte" = location of end of tib table 

00666 066476 
explain . crdly ;d .crdly 

" . crdly" - head of delay table chain 

00667 067142 
explain . crver ;d .crver 

".crver" = mcs version number, 4 chars 

00670 066056 065144 6.5d 

explain . crbrk ;d .crbrk 

".crbrk" - addr of breakpoint control table 

00672 000000 
explain . crtsw; d .crtsw 

".crtsw" = if non-zero, tracing will cease; . jq 

00673 000000^— <>*- rt 2f^ ,_- c/o^^ *T JS* 

explain .crn£s;d .crnxs;d .crnxs,* 40 >»^«H $v?Ffr$ ^oT ch^i^P/ 5 ° ("«" 
".crnxs" = next free small block C (a*» *-> rfHj*?JT 

00674 066602 

66602 066674 000056 400112 000000 066616 000004 400112 000000 

66612 066616 000004 400112 000000 066642 000020 400112 000000 

66622 066642 000004 400112 000000 066642 000004 400112 000000 

66632 - 

explain . crnbs ;d .crnbs 

".crnbs" - number of buffers devoted to small space 

00675 000014 
explain . erect ; d . erect 

".erect" =■ address of first cct descriptor 

00676 067166 
explain .crskd;d .crskd 

".crskd" - address of scheduler data block 

00677 006442 sked|1702 
explain . cretb :d .cretb 

".cretb" - list of echo -negotiation bit tables 

00700 066660 
explain . crept ;d .crept 

".crept" = address of cpu page table 

00701 004000 
explain .crpte;d .crpte 

".crpte" - address of variable cpu page table entry 

00702 004177 
explain .crtsz;d .crtsz 

".crtsz" = size of trace data buffer 

00703 004000 
explain .crmet;d .crmet 

".crmet" = non-zero if metering enabled 

00704 000001 
explain .crtdt;d .crtdt 

".crtdt" - address of tib for t&d executive channel 

00705 133512 
explain .crbtm;d .crbtm 

" . crbtm" - address of time meters for getbuf /f rebuf 

00706 045270 utilj5060 
explain . crnxe ;bufc .crnxe,* -bf 

".crnxe" — next available space in extended memory 

FNP Problems/Dumps 
MCS Debugging ' F86 Page 8-5 



135440 136740 000040 



136740 137240 000040 



137240 137340 000040 



137340 137400 000040 _. 

137400 137540 000040 _' 

137540 137700 000100 _@ 

137700 140000 000040 ' . 

140000 140100 000040 '@ 



@ 



171400 



: r -^^ 
172000 000400 z.. 



Jpc^* 1 



172000 172400 000400 z.. 

172400 173000 000400 {.. 

173000 173400 000400 {.. 

173400 000000 000400 . . . 

explain . crbpe ; d . crbpe 

".crbpe" — buffer paging window table entry 

00710 004176 

explain .crcpr;d .crcpr 

" . crcpr" = copyright notice 

f\fK~7C/\ ift0117 inmoi Acrn/.n ncnino nc-irw.n iiAnrz* iiine/- loiAri* ^*>t>t» /«v ti t n 
uv/uu iujix/ i.i.\ji.i.t. ujoutu ujuiuj ujiufu nuuju iiiujo i^jujd uurii. (,u/ n.x.o. 



00770 040111 116103 056040 061071 070061 040040 



INC. 1981 




dump 
No^IB 

line a 

d tib 
H&|-*L24512 
124522 
124532 
124542 
124552 
124562 



.a. 011084. 1126 
ilable 



v£<i 



-r\k oP ^^ 






012207 207304 400002 015334 001116 
377352 000000 000000 000000 000000 
001431 310450 000000 015332 000000 
077400 000000 013463 000013 000000 
000000 000000 000000 000000 000000 
00000 000000 077570 124620 124660 
explain t . stat* flags t.stat ■-* s ^ xs> \^ 
"t.stat" - holds current line status 

124512 012207 tsfr£s tsfd_tr,tsfrcv tsfdsr 
explain t. fig; flags t.flg . X ~"" 
"t.flg" - flag wordpfiW •* *»w'-* 

124513 207304 tfeepx^tftbec tfcrec tflfec 
explain t.flg2;fiags"~~t^TIg2~ ec A * ph * 
"t.flg2" - second word of flags 

124514 400002 tfpfnl tfdild 



123740 
277002 
131740 
000000 
000000 



114340 
000000 
000000 
000000 
000000 



000004 
000001 
000000 
000000 
000000 



tsfcts tsfcd/ 
tfquit tflisn tffdpx 
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explain t. cur; d t. cur ; $. Of^'^k P r ''« 7 £ 4 "^' ^&^ C K 
"t.cur" - current address in control table 

124515 015334 Ctrl | 1734 
explain t.linejd t.line 
"t.line" - 10 bit line number 

124516 001116 

explain t . icp ; d t . icp ; buf c t . icp , * 
"t.iep" - first buffer in input chain 

124517 123740 

123740 134440 000074 155077 153055 173157 173077 157157 057075 \ .<m?k- {o{?oo/= 
123750 175075 067157 165075 125167 077165 173165 155077 075077 }-7ou=Uw?u{um?=? 
123760 075077 077057 077077 067077 077077 153153 173173 157167 =??/??7???kk{{ow 
123770 077155 155153 173077 173173 133173 057057 155153 173177 ?mmk{?{ { [ {//mk{ . 

134440 142040 000074 157177 177177 177172 177177 165135 177177 b .<o. . . .z. .u] . . 

134450 157177 177177 177157 073173 177133 077176 177133 055055 o o ;{.[?-. [-- 

134460 077177 073133 157077 073176 176177 057177 177153 177077 ?. ; [o?;-~./. .k. ? 

134470 077073 177177 176177 177177 133173 137137 177177 077127 ?;..-...[{_.. ?W 

142040 114340 000074 135177 073167 177177 177165 177165 176176 L' .<] . ;w. . .u.u— 

142050 073067 133057 157173 157155 135133 133133 135153 157065 ;7[/o{om] [ [ []ko5 

142060 155177 177177 147073 177175 177157 177177 157133 157157 m. . .g; . } .o. .o[oo 

142070 153057 073177 155167 177177 173057 077077 153157 057155 k/; .mw. . {/??ko/m 



114340 

114350 

114360 

114370 

explain 

"t.ilst" 

124520 



"t.icpl' 

124521 

explain 

"t.icch" 

124522 

explain 

"t.elnk" 

124523 

explain 

"t.rcp" 

124523 

explain 

"t.ocp" 

124524 

Invalid 

explain 

"t.ocur" 

124525 

explain 

"t.olst" 

124526 

explain 



000000 000021 133133 153177 173065 165077 125135 155057 [ [k. {5u?U]m/ 

135077 173177 177000 000000 000000 000000 000000 000000 ]?{ 

000000 000000 000000 000000 000000 000000 000000 000000 

t.ilst;d t.ilst 
— last buffer in input chain 

114340 

*■ ; «t>i • a *■ -j «-«i 



- count of buffers in icp chain 
000004 

t.icch; d t.icch 

= address of next input character 
377352 
t.elnk; d t.elnk 

- link to tib extension 
000000 

t.rcp;d t.rcp 

" replay chain pointer (share t.elnk) 

000000 

t.ocp ;d t.ocp ;bufc t.ocp,* 

- addr of output chain from cs 

000000 

buffer address: 

t.ocur ;d t.ocur 

- addr of current output buffer 
000000 

t.olst;d t.olst 

- addr of last buffer in output chain 
000000 

t.occhjd t.occh 
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"t.occh" - addr of next output character 

124527 277002 

explain t.ocnt ;d t.ocnt 

"t.ocnt" — count of buffers in t.ocur 

124530 000000 
explain t.typejd t.type 
"t.type" - line type 

124531 000001 
explain t.time;d t.time 

"t.time" — time at which next timeout will occur 

124532 001431 310450 
explain t.reta;d t.reta 

"t.reta" = return address from calsub 

124534 000000 
explain t.dcwa;d t.dcwa 

"t.dcwa" = addr of dew list to 'execute' 

124535 015332 Ctrl | 1732 
explain t.dcwl;d t.dcwl 
"t.dcwl" = length of dew list 

124536 000000 

explain t.echo;d t.echo;d t.echo,* 40 
"t.echo" - echo buffer address 

124537 131740 

131740 377354 377354 000157 057155 133133 153177 173065 165077 
131750 125135 155057 135077 173177 177157 155135 133133 133135 
131760 153157 065155 177177 177147 073177 175177 157177 177157 
131770 133157 157153 057073 177155 167177 177173 057077 077153 
explain t.dcp;d t.dcp 
"t.dcp" — addr of message chain for cs 

124540 000000 
explain t.dlst;d t.dlst 

"t.dlst" — last buffer in mess^e chain for cs 

124541 000000 
explain t.ftse;d t.ftse 

"t.ftse" = first time slot entry in Isla table 

124542 077400 
d t.sfcm 

124542 077400 
explain t.bcnt;d t.bcnt 
"t.bcnt" «- counting temporary 

124543 000000 
explain t.brkp;d t.brkp 

"t.brkp" = pointer to current break list 

124544 013463 
explain t.pos;d t.pos 

"t.pos 1 * = current carriage position 

124545 000013 
explain t.ecch;d t.ecch 

"t.ecch" — address of current echo char (hsla only) 

124546 000000 
explain t.cntr;d t.cntr 

"t.cntr" = counter for control tables 

124547 000000 

explain t.flg3; flags t.flg3 
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"t.flg3" - third word of flags 

124550 000000 
explain t.dtp;d t.dtp 

"t.dtp" — pointer to delay table for this line 

124551 000000 
explain t.frmc;d t.frmc 
"t.frmc" = framing chars (2 chars) 

124552 000000 
explain t.dcpl ;d t.dcpl 

"t.dcpl" = number of buffers in dcp chain 

124553 000000 
explain t.scll;d t.scll 

"t.scll n - screenline length left, for echo neg. 

124554 000000 
explain t.sncc;d t.sncc 

"t.sncc" — Echo negotiation sync ctr. 

124555 000000 
explain t.entp ;d t.entp 

"t.entp" = Echo negotiation break table ptr 

124556 000000 
explain t.ifch;d t.ifch 

"t.ifch" - input flow control characters 

124557 000000 
explain t.ofch;d t.ofch 

"t.ofch" = output flow control characters 

124560 000000 
explain t.omct; d t.omct 

"t.omct" - output message count (for flow control) 

124561 000000 
explain t.itim;d t.itim 

"t.itim n - time of last call to inproc (2 words) 

124562 000000 000000 
explain t.metr;d t.metr 

"t.metr" =- address of metering area 

124564 077570 
explain t.abf0;d t.abfO 

"t.abfO" = absolute address of first permanent buffer 

124565 124620 
explain t.abfl;d t.abfl 

"t.abfl" - absolute address of first permanent buffer 

124566 124660 
explain sfcm;d sfcm 

Symbol "sfcm" has no explanation. 

124400 002340 077472 077472 000012 077512 000204 105740 

124410 000000 000000 000460 067200 000000 004374 000040 

124420 000040 377347 000000 000012 571626 000004 000000 

124430 000000 700460 000000 700460 000000 000000 000000 

124440 000000 000000 600000 700460 000000 000000 032000 

124450 000000 000000 004000 700460 000000 000000 600000 

124460 000000 000000 012000 700660 000000 000000 

explain sf.hcmjd sf.hcm 

"sf .hem" - addr of hwcm 

124400 002340 

explain sf.nxa;d sf.nxa 



103340 
000040 
700660 
000000 
700660 
700460 
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"sf .nxa" =■ addr of next available queue entry 

124401 077472 
explain sf.nxp;d sf.nxp 

"sf .nxp" — addr of next queue entry to process 

124402 077472 
explain sf.tly;d sf.tly 
"sf.tly" — tally of status queue 

124403 000012 
explain sf.tib;d sf.tib 

"sf.tib" - addr of tib for this line 

124404 077512 

explain sf. fig; flags sf.fig 
"sf.flg" - flag word 

124405 000204 sffdct sffcoi 
explain sf.ibO ;d sf.ibO,* 40 -eh 
"sf.ibO" - pointer to input buffer 1 

105740 040377 373265 365277 325335 355257 335277 373377 377377 . {5u?U]m/] ?{ . . . 
105750 377357 273173 377333 277376 377333 255255 277377 273133 .o; {.[?-.[--?.; [ 
105760 357277 273376 376377 257377 377153 377277 277273 377377 o? ;— ./• .k. ??; . . 

105770 376377 377377 333373 137137 377377 277327 335377 000000 -...[{ ..?¥]... 

explain sf.ibl;d sf.ibl,* 40 -ch 

"sf.ibl" - pointer to input buffer 2 

103340 040273 367377 377377 365377 365376 376273 267333 257157 ;w. . .u.u— ;7[/o 

103350 173157 155135 333133 333135 153357 265355 377377 377347 {om] [ [ [ ]ko5m. . ,g 

103360 273377 375377 357377 377157 133357 157353 257273 377355 ; . } .o. .o[ook/; .m 

103370 167377 377373 257277 277353 357257 355333 333353 000000 w. . {/??ko/m[ [k. . 

explain sf.ob0;bufc sf.obO,* 

"sf.obO" - pointer to output buffer 1 

Invalid buffer address: 

explain sf.obl;bufc sf.obl,* 

"sf.obl" - pointer to output buffer 2 

Invalid buffer address: 

explain sf.pcw;d sf.pcw 

"sf .pew" — current pew 2nd word 

124412 000460 
explain sf.cct;d sf.cct 

"sf.cct" - cct addr for this line, if non-zero 

124413 067200 
explain sf.rct;d sf.rct 

"sf.rct" - repeat count for status queue overflows 

124414 000000 
explain sf.hsl;d sf.hsl 

"sf .hsl" = address of hsla table entry for this line 

124415 004374 
explain sf .bsz;d sf.bsz 
"sf.bsz" — max buffer size 

124416 000040 
explain sf.fbs ;d sf.fbs 

"sf.fbs" - buffer size to be used during frame input 

124417 000040 
explain sf.mms;d sf.mms 

"sf .nnss" — maximum synchronous message size 

124420 000040 

explain sf.csz;d sf.csz 
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"sf.csz" — current asynchronous buffer size 

124420 000040 
explain sf.rms;d sf.rms 

"sf .rms" — remaining unallocated message length 

124421 377347 
explain sf.nic;d sf.nic 

"sf.nic" = char, address of next asynchronous input char 

124421 377347 
explain sf .noc;d sf .noc 

n sf .noc" - char address of next asynchronous output char 

124422 000000 
explain sf.cfgjd sf.cfg 
"sf.cfg" - 2 words for config pew 
124424 571626 000004 

explain sf .waq;d sf.waq 

"sf .waq" — wrap around queue, software status q 

124442 600000 700460 000000 000000 032000 700660 000000 000000 

124452 004000 700460 000000 000000 600000 700460 000000 000000 

124462 012000 700660 000000 000000 024000 700460 000000 000000 

124472 004000 700460 000000 000000 600000 700460 000000 000000 

124502 012000 700660 000000 000000 024000 700460 000000 000000 

explain sf.sta;d sf.sta 

"sf.sta" — hardware status q, slew here 

124426 000000 700660 000000 700460 000000 700460 000000 000000 

124436 000000 000000 000000 000000 

d hwcm 

02340 105747 460057 103340 460075 131754 470000 131754 450000 

02350 672000 124400 000000 000000 124426 420005 443026 010004 

explain h.ric0;d h.ricO 

"h.ricO" - primary receive icw 

02340 105747 460057 

explain h,ricl;d h.ricl 

"h.ricl n - alternate receive icw 

02342 103340 460075 

explain h.sic0;d h.sicO 

"h.sicO" — primary send icw 

02344 131754 470000 

explain h.sicl ;d h.sicl 

"h.sicl" =- alternate send icw 

02346 131754 450000 

explain h.baw;d h.baw 

"h.baw" = base address word 

02350 672000 
explain h.sfcm;d h.sfcm 

"h.sfcm" — software comm. region address 

02351 124400 
explain h.mask;d h.mask 
"h.mask" - mask register 

02352 000000 000000 
explain h.aicw;d h.aicw 
"h.aicw n - active status icw 
02354 124426 420005 
explain h.cnfg;d h.cnfg 
"h.cnfg" - configuration status 
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02356 443026 010004 

explain m.dql ;d m.dql 

"m.dql" - cumulative length of dia request queue 

124570 000000 000035 

explain m,dqu;d m.dqu 

"m.dqu" - updates of m.dql 

124572 000000 000072 

explain m.nst; d m.nst 

"m.nst" - cumulative no. of pending status 

124574 000000 006023 

explain m.nsujd m.nsu 

"m.nsu" - updates of m.nst 

124576 000000 006220 

explain m.over;d m.over 

"m.over" — output overlaps 

124600 000000 
explain m.par;d m.par 
"m.par" - parity errors 

124601 000000 
explain m.ssqo;d m.ssqo 

"m.ssqo H - software status queue overflows 

124602 000000 
explain m.hsqo;d m.hsqo 

"m.hsqo" - hardware status queue overflows 

124603 000000 
explain m . inaf ; d m . inaf 

"m.inaf" = input allocation failures 

124604 000000 
explain m.cql;d m.cql 

"m.cql" - current length of dia request queue 

124605 000000 

exp j_a 2.n si . exu ] \* m . exu 
"m.exh" - exhaust status 

124606 000000 000000 
explain m.xte ;d m.xte 
"m.xte" - software xte status 
124610 000000 

explain m.prex;d m.prex 
"m.prex" = pre-exhaust status 
124612 000000 000000 
explain m.ebof ;d m.ebof 
"m.ebof" - echo buffer overflows 
124614 000000 000000 
explain m.quit;d m.quit 
"m.quit" - bell -quits 
124616 000000 
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debug_fnp documentation 
Name : debug_fnp, db_fnp 

The debug_fnp command is a debugging aid intended to be used by FNP software 
developers and in FNP dump analysis. The command can be used to patch or 
dump memory in a running FNP, to examine a dump from a crashed FNP or a core 
image segment before it is loaded, to set breakpoints in a running FNP, 
symbolically display FNP control blocks, buffers, etc. 

Usage 

debug_f np { initial_command_line } 

where initial_command_line is the first command(s) debug_fnp is to execute. 
Once the initial command(s) , if any, are completed, debug_fnp reads command 
lines from user_input. Each line may contain multiple commands, seperated by 
semi -colons. If an error occurs in any command, the remainder of the 
commands on that line will not be executed. Any debug_fnp command can be 
aborted by issuing a "Quit" followed by a Multics "program_interrupt n 
command. 

Selecting debug fnp mode 

The debug_fnp command can be setup to operate on either a running FNP, a dump 
segment, or a core image segment. When first invoked, the command is setup 
to examine the first configured FNP. It is possible to switch betweens 
dumps, core images, and running FNP'S at any time. With few exceptions, most 
debug_fnp commands work the same regardless of whether a running fnp, a dump, 
or a core imap'e is selected. 

To select a running FNP: 

fnp tag 
where "tag" is "a", "b", "c", or "d" . 
To select a core image: 

image path 
To select a dump: 

dump path 

where path is the Multics pathname of a segment containing the dump or the 
core image. Core image segments and dump segments have a different format, 
so these commands are not interchangeable. The pathnames on the dump and 
image commands can also be starnames, providing they match one and only one 
entry in the directory specified. 
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In most cases, it is not necessary to know the path name of the dump to be 
examined, as special commands are provided for selecting dumps. 

To list all the dumps currently in the dump directory: 

dumps 
The default dump direcotry is ">dumps" but this can be changed by: 

dump_dir {path} 

where path is the pathname of the new dump directory. If "path" is omitted, 
the name of the current dump directory will be printed. 

To select the latest dump: 

last_dump 
The next earliest dump can be selected with: 

prev_dump 
The prey_dump command can be used repeatedly as long as there are more dumps . 
To select the next latest dump: 

next_dump 

The next_dump and prev_dump commands can be used to peruse any or all of the 
dumps in the dump directory, going in either direction. 

If dealins with a dunro which contains muT finis FNP's *mrh a rd.<? •FHiimn t-ha 
following command is used to select which FNP in the dump is examined: 

select_fnp tag 
where tag is "a", "b", "c" , or "d". 
To find out what FNP, dump, or core image is selected: 

what 
will print the fnp tag, or the pathname. 

Expressions 

Many of the following commands take numeric arguments such as addresses, 
lengths, etc. Any of these arguments can be expressed as a generalized FNP 
expression. Expressions can be arbitrarily complex, containing "(", ")", 
"+", "-", •**", and "/" with their normal meanings and precedence. The symbol 
"|" is synnonomous with "+" , as in module j offset. Indirection can be 
specified by ",*", following the address to indirect thru. Numeric constants 
are interpreted as octal , unless they are followed by a " . " , in which case 
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they are decimal. The symbol "*" can be used for the current location 
counter, which is generally the last address used in a diaplay or patch 
command. Many common FNP symbols can also be used, including all fields in 
the system comm region, the hardware comm region, the software comm region, 
and the TIB. (Note: before TIB, hwcm, and sfcm addresses can be used, the 
addresses of these control blocks must be established. See the "line" and 
"set" commands). A symbol may also be any opblock mnemmonic, the name of any 
FNP object module, or a machine instruction (specified by surrounding the 
instruction by apostrophes). In additon, user symbols can be defined. 
Examples of expressions: 

hs la | 500 

t . icp , * 

*+30 

tib|14,*+10 

goto 

'Ida 0,2,b.0' 

cax3 (apostrophe not needed if no operand) 

Displaying FNP memory 

To display the contents of FNP words: 

display address {length} {mode} 
d address {length} {mode} 

where "address" is the starting address, "length" is the number of words, and 
"mode" is the display mode. The symbol "*" will be set to the address 
sepcified. The following display modes can be used: 

octal, oct 

character , ch 

address, addr (in form module | offset) 

clock, ck (4 FNP words as a Multics clock) 

instruction, inst (355 instruction format) 

opblock, op (pseudo opblock format) 

decimal, dec 

bit 

ebcdic , ebc 

If omitted, the length defaults to 1 unless "address" is a predefined FNP 
symbol, in which case the appropriate length for that symbol will be used. 
Similarly, if the mode is omitted, octal is used, unless "address" is a 
predefined FNP symbol in which case the mode appropriate for that symbol is 
used. 

To display a buffer: 

buffer {address} {mode} { -brief | -bf } 
buf {address} {mode} { -brief | -bf } 

where "address" is the address of the buffer, "mode" is the mode to display 
it in (see display command) , and -brief means display only the first 2 words 
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of the buffer. If "address" is omitted, the next buffer pointer from the 
previous buffer displayed is used. If "mode" is ommitted, character mode is 
assumed. If -breif is not specified, the entrie buffer is displayed, the 
length is determined automatically by reading the buffer header. 

To display a buffer chain: 

buffer_chain {address} {mode} { -brief |-bf} 
bufc {address} {mode} { -brief] -bf} 

If the data being displayed is in the form of threaded control blocks, the 
following commands can be used: 

block {address} {-offset|-o offset} {-length|-l length} 
blk {address} { -offset | -o offset} {-length|-l length} 

will display a control block at the address specified. The length of the 
block is specified with -length. The default is 8 words. The offset to the 
forward pointer in the block is specified with -offset. The default is 0. 
If the address is not specified, the next block in the chain will be 
displayed (using the forward pointer from the previous block) . 

To display the entire chain of control blocks: 

block_chain {address} {-offset|-o offset} {-length|-l length} 
bike {address} {-offset|-o offset} {-length|-l length} 

will display control blocks until one with a zero forward pointer is 
encountered. 

where the arguments are the same as in the buffer command. This command will 

follow the threads in the Hii-F-Fe-r rhain rK cnl auinir oa^l-i Knffor 

If the data being displayed is a word of flags, the flags command can be used 
to show the setting of individual bits. 

flags address {type} 

where address is the the address of the word containing flags, and the type 
can be: 

t.stat tib status word 

t.flg first tib flag word 

t . f lg2 second tib flag word 

sf.flg hsla sfcm flags 

istat interpreter status word 

hs.l first word of hsla hardware status 

hs.2 second word of hsla hardware status 

If {type} is ommitted, it is assumed to be the same as "address", which then 
must be one of the items in the above list. The flags are listed by name, as 
they appear in the macros. map355 source file. The explain command (see other 
commands) can be used to help with unfamiliar names. Occasionally, the value 
of a flag word is known (from a trace, for example), without knowing an 
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address of it. In this case, the following form can be used: 

flags -expression type 

where expression is any valid expression, and type is one of the types shown 
above . 



Patching FNP Memory 

To patch the contents of FNP memory: 

patch address argl ... {argn} 

where address is the starting address to patch, are the argi represent patch 
data. Each argi may be an expression representing the value to be stored in 
1 FNP word, or a character string in quotes (which may contain more that 1 
word of data) . The total number of words patched cannot exceed 32 . Before 
the patch is applied, the effects of the patch are displayed (old and new 
contents of every word) and the user is asked to verify that the patch is 
correct. The symbol n * n will be set to the address specified. Examples of 
patch commands: 

patch 43102 203456 -1 2 

patch .crver "3.1x" 

patch ctrl j 1400 goto Ctrl | 1600 

patch hsla|1541 'tze 13' cax3 'Ida 0,2,b.l' 

A shorthand form of this command is: 

-argl . . . {argn} 
which is equivilent to: 

patch * argl . . . {argn} 

Individual flag bits in words of flags can be manipulated with the following 
commands : 

set_flag flag_symbol 

will set the bit associated with the flag_symbol specified in the appropriate 
word. In a similiar way, 

clear_flag flag_symbol 

will clear an individual bit. Currently, these commands are not indivisible 
operations: this means if other flags bits in the word are dynamically 
changing, these command may change their value if they happen to have been 
changed between the time the word was read and when it was rewritten. 

Dump Analysys Commands 
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The following commands are only valid when using debug_fnp on a dump. 

To find out the cause of a dump: 

why 

will print the type of fault which caused the crash, and if the crash was 
caused by a "die" opcode in the FNP, will interpret the reason for the 
crash . 

The command: 

regs 

will print the contents of all machine registers at the time of the fault. 

If the fault occured in a subroutine (as defined by the map355 'subr' macro), 
information about the call is available with: 

call_trace address {-long|-lg} 

This command will start at the address specified and perform a backwards 
trace of all subroutine calls. If -long is specified, the registers saved at 
each subroutine level will also be printed. This command can also be used on 
a running FNP, but the infromation is probably changing too fast for the 
command to be useful. 



FNP Trace Tables 

A running FNP or a dump will contain a trace table of the most recent events 

rif*f**Trn -r\rr 4 -r> +-T^>-» TNTO T*U^ *--*.«._** fc«1.1« — T j: 1 J — 2 *-!_ . 

print_trace {start} 
print_trace {start} {count} 

where start indicates the starting trace message and count is the number of 
messages to display. If no arguments are given, the entire trace table is 
printed. If no count is given, the trace tables is displayed from the 
starting point specified to the end. If the start number is positive it is 
counted from the oldest message; if negative, it is counted from the most 
recent. For example: 

print_trace 200. 
will skip the 199 oldest entries and print. the rest. 

print_trace -50. 

will print the 50 most recent messages . 

Printing the trace table of a running FNP is only meaningful if tracing has 
been suspended; otherwise the table is changing too fast to be interpreted. 
Tracing can be suspendend in a running FNP by: 
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stop_trace 

and restarted with: 

start_trace 

Tracing can also be stopped and started with some of the breakpoint commands 
explained below. 

Which modules in the FNP are traced is determined by the trace mask, kept in 
FNP memory. This mask may be examined or updated with: 

trace_mask {modules} 

If used with no arguments, trace_mask will display and interpret the current 
trace mask. If modules are given, they represent modules to be added to or 
deleted from the current mask. The module should be specified as 'name' or 
'+name' to set the tracing bit for the module; it should be '-name' or 
,A name' to turn off the corresponding bit. In addition, all and none may be 
specified. For example: 

trace_mask hsla A dia -lsla 

will turn on tracing for hsla_man and turn off traceing for dia_man and 
lsla man. 



FNP Breakpoint facility 

The control table interpreter in the FNP allows breakpoints to be set in the 
interpreted control tables. A breakpoint will cause the line encountering it 
to stop execution in the interpreter until a command is given to restart it. 

Breakpoints are often a useful tool but a certain amount of care must be 
excercised in their use. The following points are important: 

1. Breakpoints can only be set in interpreted opblocks. They cannot be set 
at machine instructions. 

2. While at a break, the line is executing an opblock equivilent to: 

wait 0,0,0 

followed by no status blocks. This means that timers can runout unnoticed, 
status will be ignored, hangups can be missed, etc. For this reason, it may 
be difficult to restart a channel after a breakpoint. 

3 . Breakpoints cannot be set at subroutine levels where waits would be 
illegal. 

4. Breakpoints cannot be set when a restart may execute a waitm opblock. 

5. Breakpoints cannot be set at a status opblock. 
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6. If a breakpoint is set at a wait opblock, it must be reset before the 

line is restarted. In addition, a breakpoint may not be set at a wait if any 
channels are currently waiting at that block. 

7. Control tables that use local internal variables (as opposed to variables 

in the TIB extension) cannot depend of these variables being preserved during 
the break unless other channels that may use the same control tables are not 
running. 

8. No notice is given when a channel encounters a breakpoint. The 
list_break command will list all breakpoints and show what channels are 
stopped at each one. 

To set a breakpoint: 

set_break address -line- {-stop_trace} 
sb address -line- {-stop_trace} 

will set a breakpoint at the address specified. If a tty channel is given, 
the breakpoint will apply to that line only. Any other channel encountering 
the breakpoint will continue execution. If -stop_trace is specified, the FNP 
will automatically suspend tracing if any channel stops at that breakpoint. 

To reset a break: 

reset_break address 
reset_break -all 
rb address 
rb -all 

will reset a break at the address specified. Any lines stopped at the break 
are not automatic-all'"' restarted. If -all is specified all breaks will be 
reset. 

To start a channel stopped at a breakpoint, 

start line {address} {-reset} { -start_trace} 
start -all 

sr line {address} {-reset} { -start_trace} 
sr -all 

will restart the line specified. If an address is given, the line will be 
restarted at the address given, instead of where it was stopped. If -reset 
is specified, the break will be reset before the line is started. If 
-start_trace is specified, tracing will resume as the line is restarted. If 
-all is specified, all lines at breakpoints at the time the command is issued 
will be restarted. 

To list fnp breakpoints: 

list_break 
lb 
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will list all FNP breakpoints and the channels stopped at each. 

Peformance Analysis Commands 

The FNP software periodically samples the instruction counter to determine 
whether the FNP is running or idling. This meter can be displayed with the 
fnp_idle command, as follows: 

idle_time {-reset|-rs} 

will print the percent of time the FNP has been idling since bootload, or the 
last time the command was invoked with the -reset control argument. 

The sampling interval used by the FNP for metering this data can be printed or 
set with the following command: 

sample_time {new_time} 

where new_time, if specified, is the new sampling interval in milliseconds. 
The argument must be between 1 and 1000. If no argument is given, the current 
sampling interval is printed. The default sampling time when the FNP is 
booted is 50 milliseconds. 

More detailed information on FNP usage can be collected by configuring the 
module 'ic_sampler' in the FNP core image. This module will periodically 
sample the instruction counter (at the rate set by the sample_time command) 
and add 1 to a bucket which represents a small range (typically 16) of FNP 
addresses. With this data it can be determined with some precision where the 
FNP is spending its time when it is running. 

This instruction counter sampling feature is controlled b ,T the ic saur 1 ** 
command, whih is only accepted if the ic_sampler module is configured in the 
FNP. The following options of the command are used to control ic sampling: 

ic_sample start 

starts the ic sampling feature. Sampling is normally disabled when the FNP is 
booted. 

ic_sample stop 
stops ic_sampling. 

ic_sample reset 
zeroes all the sampling buckets . 
The following options are used to display the information collected: 

ic_sample module 

prints a table showing each module in the core image and what percentage of 
samples collected occur in that module. 
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ic_sample histogram! hist {fraction} 

prints a histogram showing each bucket address that has data, and the percent 
of non-idle time that bucket represents. The fraction argument, if specified 
must be a floating point number between 0.0 and 1.0. If this option is used, 
the histogram will only contain the most frequently used buckets. Enough 
buckets will be printed so that fraction specified of the total data collected 
will be printed. For example, if the fraction is .9, 10% of the data 
collected will not be display by discarding infrequently referrenced buckets. 
This option is useful in deleting "noise" from the histogram. 

Other commands 

To select a specfic tty line: 

line {line} 

will locate the TIB, software comm region, and hardware comm region of the 
line specified. Once these addresses are set, fields in these control blocks 
can be referenced by name in any expression in other commands. The line can 
be specified either in Multics form (a.h012) or as an FNP line number 
(1014) . If no line is specified, the name of the current line is printed. 
If the line selected is not on the current FNP, the proper FNP will be 
selected automatically. 

To print a summary of FNP buffer usage: 

buf f er_status { -brief | -bf } 
bstat {-brief|-bf} 

wij-j. prxnt a ta UJ .e snowing each line and how much buffer space in the FNP it 
is using. If -brief is used, only summary information is printed. 

To set a symbol: 

set symbol value 

where symbol is '*', 'tib', 'hwcm' , 'sfcm', or any user defined symbol. 
Setting control block addresses (tib, hwcm, sfcm) is more easily done with 
the line command, but can be manually done with the set command in case 
internal FNP tables have been damaged. Note that setting any of these 
control block addresses has no effect on the current value of other control 
blocks. Setting "*" is also done by any dump or patch command. Once set, a 
symbol may be used in any expression in any other command. 

To display a list of modules in the core image : 

map 

will display a list of modules and their addresses. 

To interpret an FNP address: 
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convert_address {addressl} . . . {addressn} 
cva {addressl} . . . {addressn} 

will convert the address to any other meaningful form that can be derived. 
For example, octal values will be converted to module] offset, and vice 
versa. 

To find the explaination of any FNP symbol (usally the output of a flags or 
convert_address command) : 

explain syml {sym2} ... {symn} 

where symi are symbols to be explained. This command will print the comment 
form the line in macros. map355 that defined the symbol. 

To execute any Multics command: 

e Command Line 
will pass 'Command Line' to the command processer. 
To exit from debug_fnp, 

quit 

q 
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a Multics Problems/Dumps 
I I tty_analyze 

I tty_dump 
I trace_mcs 
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tty_dump 

LCTE at 13100, channel c.h212, devx 257 

channel type: tty (0) 

flags: in_use initialized 

physical channel devx 257, major channel devx 165, subchannel 72 

input_words 16, output_words 

data base at 71124 

WTCB at 71124, channel c.h212, devx 257 

line type = ASCII, baud rate - 2400 

flags : listen, dialed, send_output , tcb_initialized, breakall 

hevent =■ 000464004602 407777000311, event = 007777000001 400000000002 

fblock - 201512, lblock « 201512, fchar - 

at line 0, column 0, white_col - 

read-ahead messages 

write_first - 0, write_last - 

maximum buffer size - 16, buffer pad - 

line delimiter - " 



TCB at 55010 

terminal type = , old type =» 

modes : rawi , rawo , f ulldpx , ctl_char , breakall , can_type=overs tr ike 

flags : uproc_attached 

shift state - 00 (none) 11-0, pi - 

answerback id — none 

erase #, kill @, frame_begin \000, frame_end \000 

input message size characters 

input_translation 

output_translation 

input_conversion 

output_conversion 

special 

delay 

read 

201512 size = 16, tally = 49, flags: 

000000000061 123145164164 151156147040 124145155160 ...lSetting Temp 

157162141162 171040160157 151156164145 162163040146 orary pointers f 

162157155040 067063174062 064060056015 012015012141 rom 73 | 240..... a 

172155072040 040000000000 000000000000 000000000000 zm: 
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Lq^cM CU->P ( n*#* b^/ tty_dump 

LCTE at 10000, channel c.h016, devx 175 
channel type: x25 (11) 
flags: in_use initialized 

physical channel devx 175, major channel devx 165, subchannel 10 
input_words 0, output_words 
data base at 127752 

X.25 devx 175, 32 lc, 33 sc, ACTIVE flags: started send_output no_d 
packet_threshold=129 address-56 



LCTE at 41200, channel c.h016.001, devx 1021 

channel type: tty (0) 

flags: in_use initialized 

physical channel devx 1021, major channel devx 175, subchannel 1 

input_words 0, output_words 

data base at 131350 

WTCB at 131350, channel c.h016.001, devx 1021 

line type - ASCII, baud rate - 4800 

flags : listen, dialed, send_output , qenable , tcb_initialized,hndlquit , count_lines 

hevent - 000464013026 407777000721, event - 007777000001 400000000001 

process blocked on input 

fblock - 0, lblock - 0, fchar - 

at line 7 , column , white_col = 

read- ahead messages 

write_first = 0, write_last = 

maximum buffer size - 16, buffer pad = 5 

line delimiter = " 



TC3 at 150604 

terminal type = VIP7205, old type = 7 

modes : can , esc , erkl , If echo .hndlquit , echoplex , polite , scroll , can_type=replace 

flags : uproc_attached 

shift state = 00 (none) 11 = 80, pi = 23 

answerback id = 3106 

erase #, kill @, frame_begin \000, frame_end \000 

input message size characters 

input_translation 

output_translation 

input_conversion 60 

output_conversion 170 

special 344 

delay 



Multics Problems/Dumps 
MCS Debugging F86 Page 8-26 



tty analyze US^ PWlJUs Sy5?Pi>* u " j 

Begin analysis of ERF 66 ^ fC/v£> D^^P- 

Header Values: ft „ „, AvA Y<T^ T ^ arT V' 

bleft 6366, free 61212 ^ * T» ^ ," U W^*** 

Physical channel c.h016, 4800 baud, devx 175, pcb 65460, lcte 10000, line type X25LAP 
flags: listen dialed send_output sync_line 

multiplexer type: x25 

X.25 devx 175, 32 lc, 33 sc, ACTIVE flags: started send_output no_d 

packet_threshold=129 address=»56 
X.25 SC 1 c.h016.001 devx 1021: DIALED output_ready wru echoplex hndlquit polite Ifech 
LC 16: state=p41(FL0W CONTROL READY) ,max__packet_size=128, window used=0/2 
iti baud=4800 
address=31063050005411 

Subchannel: c.h016.001, devx 1021 

wtcb at 131350 

flags : listen , dialed , send_output , qenable , hndlquit , count_lines , scroll 

blocked for input 

Physical channel c.h212, 2400 baud, devx 257, pcb 66300, lcte 13100, line type ASCII 

flags : listen dialed send_output 

wtcb at 71124 

flags: listen, dialed, send_output,breakall 

Read chain trace 

FBL0CK 

201512 size = 16, tally = 49, flags: 

000000000061 123145164164 151156147040 124145155160 157162141162 171040160157 15115616 

162157155040 067063174062 064060056015 012015012141 172155072040 040000000000 00000000 

Begin free chain trace 
61212 (2 words) 
61474 (16 words) 
62016 (6 words) 
62122 (2 words) 

202732 (140 words) 
203312 (10466 words) 

Begin unthreaded space check 
154702 (40 words) 
157276 (14402 words) 
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r> 



i* 



trace_mcs ts 100 — w * f 
r 08:22 0.199 94 



As. **■ e 



V r»vC. ~°) 



C^f i"\ 



TV 



up 



.f.?5 



tracejmcs modes all 

New MCS trace modes : on, A default , read, write , data, control .modes , interrupt , 

init_mpx , start_mpx , stop_mpx , space_man 

r 08:23 0.199 89 



trace_mcs channel ** -on 
r 08:24 0.435 91 



trace 

08 : 24" 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 

08:24: 



mcs print 
"55.331876 
55.334231 
55.336228 
55.337438 
55.339879 
55.342078 
55.345253 
55.348781 
55.349907 
55.353048 
55.390663 
55.398741 
55.400093 
55.403383 
55.404609 
55.408170 
55.411969 
55.423650 
55.426293 
55.427510 
55.430770 
55.431998 
55.433199 
55.629519 
55.631780 
55.633764 
55.634967 
55.645811 
55.786612 
55.788824 
55.790779 
55.791978 
55.969268 
55.971547 
55.973504 
55.974704 
55.987471 
56.002503 
56.003797 
56.007063 
56.008293 
56.009492 



fV.^5 ej\ £VQ^s. 



a.h214: 
a.h214: 
a.h214: 
a.h214: 
a.h214. 
a.h214. 
a.h214. 
a.h214: 
a.h214: 
a.h214: 
a.h214. 
a.h214. 
a.h214. 
a.h214. 
a.h214. 
a.h214. 
a.h214. 
a.h214: 
a.h214: 
a.h214: 
a.h214: 
a.h214: 
a.h214: 
a.h214: 
a.h214: 
,h214: 
.h214: 
.h214: 
.h214: 
a.h214: 
a.h214: 
a.h214: 
a.h027: 
a.h027: 
a.h027: 
a.h027: 
a.h027: 
a.h027: 
a.h027: 
a.h027: 
a.h027: 
a.h027: 



flags : break 
:24 0.39 
8 



a. 
a. 
a. 
a. 



int: proc accept_input 024130024130000007604103 
16 words at 024130; 7 chars; flags: 

0: 000000000007 003144020000 d. . 

8: 010161215000 000000000000 .q 

001: int: proc accept_input 024130024130000002404103 
001: 16 words at 024130; 2 chars; flags: break 

001: 8: 010161215000 000000000000 .q.. 

write: 216 | 41214: 6 bytes 
16 words at 041214; 6 chars; flags: break 

8 : 240412000000 000000000000 

001: control: resetjoaore 77777 11 
001: write: 216 | 24130: 19 bytes 
001: 16 words at 024130; 19 chars; 
001: 8: 072062064040 060056063071 
001: 16: 060040070015 012015012000 
001: int: queued send_output 000000000000000000000000 
001: int: proc queued send_output 000000000000000000000 
int: proc send_output 000000000000000000000000 
write: 216 | 24130: 24 bytes 
16 words at 024130: 24 chars: flaes: break 

8: 242162240060 270072262264 .r.0.:.. 
16: 240060056063 071060240270 .0.390.. 

24: 215012215412 000000000000 

int: proc accept_input 024130024130000005604103 
16 words at 024130; 5 chars; flags: 

0: 000000000005 003206020000 

8: 041000000000 000000000000 ! 

int: proc send_output 000000000000000000000000 
int: proc accept_input 024130024130000005604103 
16 words at 024130; 5 chars; flags: 

0: 000000000005 003250020000 

8: 101000000000 000000000000 A. 

int: proc accept_input 024130024130000011404103 
16 words at 024130; 9 chars; flags: 

0: 000000000011 156145167137 new_ 

8: 160162157143 012000000000 proc 

control: set_required_access_class 366 | 5160 
write: 216 | 24130: 60 bytes etc. 
16 words at 024130; 60 chars; flags: 

8: 040144151163 143157156156 disconn 
16: 145143164145 144040160162 ected pr 
24: 157143145163 163040167151 ocess wi 
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08:24:56.010691 a.h027: 32: 154154040142 145040143157 11 be co 

08:24:56.011892 a.h027: 40: 156156145143 164145144040 nnected 

08:24:56.013123 a.h027: 48: 164157040164 150151163040 to this 

08:24:56.014348 a.h027: 56: 164145162155 151156141154 terminal 

08:24:56.015472 a.h027: 16 words at 041214; 18 chars; flags: break 

08:24:56.018778 a.h027: 8: 145162040156 145167137160 er new_p 

08:24:56.020008 a.h027: 16: 162157143056 015012000000 roc 

08:24:56.059137 a.h027: int: proc send_output 000000000000000000000000 

08:24:56.169153 a.hOOO: write: 216 | 24130: 60 bytes etc. 

08:24:56.170605 a.hOOO: 16 words at 024130; 60 chars; flags: 

08:24:56.172639 a.hOOO: 0: 041214000074 040060070062 ! . .< 082 

08:24:56.173865 a.hOOO: 8: 064040040141 1630040040 4 as 

08:24:56.175127 a.hOOO: 16: 103117116116 105103124040 CONNECT 

08:24:56.176354 a.hOOO: 24: 126111120067 062060065040 VIP7205 

08:24:56.177579 a.hOOO: 32: 040156157156 145040141056 none a. 

08:24:56.178779 a.hOOO: 40: 150060062067 040115157162 h027 Mor 

08:24:56.179977 a.hOOO: 48: 145154154157 056101111130 ello.AIX 

08:24:56.181180 a.hOOO: 56: 137101124015 012000000000 _AT 

08:24:56.182305 a.hOOO: 16 words at 041214; 21 chars; flags: break 

08:24:56.238164 a.hOOO: int: proc send_output 000000000000000000000000 

08:24:56.823444 a.h027: check_modes: 230|1460 

08:24:56.826460 a.h027: set_mor?s: 230 | 1460 

08:24:58.363862 a.h006: int: proc accept_input 024130024130000025604103 

08:24:58.366380 a.h006: 16 words at 024130; 21 chars; flags: 

08:24:58.368450 a.h006: 0: 000000000025 003106020000 F. . 

08:24:58.369678 a.h006: 8: 346164162141 143145137155 .tracejn 

08:24:58.370917 a.h006: 16: 143163040160 162151156164 cs print 

08:24:58.372126 a.h006: 24: 015000000000 000000000000 

08:24:58.374735 a.h006.001: int: proc accept_input 024130024130000020404103 

08:24:58.376945 a.h006.001: 16 words at 024130; 16 chars; flags: break 

08:24:58.380116 a.h006.001: 8: 145137155143 163040160162 ejncs pr 

08:24:58.381505 a.h006.001: 16: 151156164012 162151156164 int.rint 

08:24:58.382702 a.h006.001: 24: 015000000000 000000000000 

08:24:58.386288 a.h006: write: 216 j 41214: 6 bytes 

08:24:58.387422 a.h006: 16 words at 041214; 6 chars; flags: break 

08:24:58.390562 a.h006: 8: 216412000000 000000000000 

08:24:58.462541 a.h006: int: proc send_output 000000000000000000000000 

08:24:58.533918 a.h027: control: copy_meters 77777 |1 
r 08:25 0.929 89 
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10 March 82: trace_mcs 

Function: Controls the MCS tracing facility and prints MCS trace table 
entries . 



Syntax: trace_mcs print {channel_name(s) } {-control_arguments} 
trace_mcs reset 

trace_mcs modes {new_modes} { -control_arguments} 
trace_mcs channel {channel_name(s) } {-control_arguments} 
trace_mcs table_size (new_table_size} { -control_arguments} 

List of keywords: 

print, pr, p 

Prints entries from the trace table. 

reset, rs 

Resets MCS tracing: sets global modes to off , "default, none, sets the 
trace table size to zero, and turns off both channel tracing flags 
for all channels. No additional arguments are allowed. 

modes 

Prints the current global tracing modes, or changes the specified 
modes if a new_modes argument is present. See "List of modes", below. 

channel , chn 

Prints or changes the tracing flags for a single channel or group of 
channels. At least one of printing or changing must be specified, and 
at least one channel_name must be specified. 

table_size, ' ts 

Changes the size of the MCS trace table. The table size may only be 
changed when tracing is di sah1 s»d anH 4-F a ^aro f- a Mo *»•<*■? .?*-«» •»-%,« 
size must be first changed to zero and then to the new value in order 
to change the size to a different nonzero value. If no new table size 
is supplied, the current table size is printed. 

Arguments : 

channe l_name ( s ) 

Up to 20 different channel names may be specified. The channel names 
may be starnames, and all channels which match any of the supplied 
names is selected for the operation. 

new_modes 

Is the new mode string containing the global MCS tracing modes to be 
changed. See "List of modes", below. 

table_size 

Is a decimal integer specifying the number of entries in the MCS 
trace table. Each entry occupies 16 words in tty_buf. The program 
queries if the new trace table size will occupy more than 50 percent 
of the free space in tty_buf, to guard against errors. 

Control arguments (all functions) : 
-erf NNN 
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Takes the MCS trace table from the FDI3MP for ERF NNN. If this 
argument is specified, no parameters (modes, channel flags, table 
size) may be changed, although they can be printed. 

Control arguments (print) : 
-reset, -rs 

Resets the last trace entry indicator in trace_mcs. Normally, only 

those entries which have been added to the trace table since the last 

time entries were printed are printed. If -reset is specified, the 

next use of trace_mcs will print all the trace table entries, 
-all, -a 

Prints all trace table entries, but without resetting or changing the 

last entry indicator, 
-last NNN, -It NNN 

Prints the last NNN entries in the trace table, without resetting or 

changing the last entry indicator. 
-reverse, -rev 

Prints the entries in reverse order. This can only be specified if -all 

or -last is also specified. 
{-channel} XXX, {-chn} XXX 

Selects a channel or group of channels for printing. This control 

argument need not be supplied before the channel name, and is 

provided only for compatibility. 

Control argumentds (channel) : 

-print, -pr 

Causes the state of the channel trace flags for the selected channels 
to be printed. If -on or -off is also specified, both the previous 
and new states are printed. 

-on 

Turns on the "trace" flag for the channel (s) . If this flag is 
different from the "default" global mode, and the force flag is not 
also set, the channel is traced. If the force flag is set, the 
channel is traced regardless of the state of the "default" mode 

-off 

Turns off the "trace" flag for the channel (s). Only one of -on and 
-off may be specified, 
-force, -fc 

Sets the "force" flag for the channel. If the force flag is set, the 
channel is traced or not depending only on the state of its "trace" 
fag, and not on the "default" mode. If -force is specified, one of 
-on or -off must also be specified. 

Control arguments (modes) : 
-brief, -bf 

Suppresses the printing of the new mdes after the change is applied. 

Normally, the modes now in effect are printed, 
-long, -Ig 

Prints the new mode string after the changes are applied (Default) . 
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List of modes: 

on 

Whether tracing is enabled at all. The "on" mode may also be 
represented as " A off n , and " A on" as "off". 

default 

Whether channels are traced by default. Normally, this is off, 
meaning that only channels whose trace flag is set are traced. 

all 

May only be specified as "all", not " A all". This mode is a shorthand 
for setting all the remaining modes (except "none"), used to turn on 
tracing for all MCS events. 

none 

May only be specified as "none", and not as " A none". This mode is 
shorthand for resetting all the remaining modes. It is usually used 
in combination with some other mode or modes, to trace only those 
specific operations. 



read 

Whether channel_manager$read operations are traced, 
write 

Whether channel_manager$write operations are traced, 
data 

Whether the data in read and write operations is to be recorded in 

the trace table, as well as the events themselves, 
control 

Whether channel_manager$control operations are traced, 
modes 

Whether channel_manager$check_modes , get_modes, and set_modes 

operations are traced. 



interrupt 

Whether channel_manager$ interrupt, interrupt_later, and 

queued_interrupt operations are to be traced, 
initjmpx 

Whether to trace priv_channel_manager$init_multiplexer operations. 
start_mpx 

Whether to trace priv_channel_manager$start_multiplexer operations. 
stop_mpx 

Whether to trace priv_channel_manager$stop_multiplexer operations. 
space_man 

Whether to trace calls to tty_space_man requesting non-buffer type 

space. (Apparently not implemented) 



Access required: 

Access to phcs_ is required to print the trace table of the running 
system. Access to the FDUMP is required to access the trace table in an 
FDUMP. Access to hphcs_ is required to change any parameters for the 
running system. 



Notes : 
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The MCS trace table is kept in a circular array, with old entries being 
overwritten by new ones. Each entry contains the time, the device index 
of the associated channel, and a short string identifying the operation. 
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a Typical Problems 
FNP load fails 
FNP Gr ashes 

FNP Crashes Repeatedly 
Multiplexer won't load 
Channel won't dial up 
Channel dials up but no I/O 
Frequent quit signals 
User dials into wrong process 
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dn3S5_data.inol.pll segment in: >ldd>inelude contents modified: 11/09/84 0855.8 

entry modified: 06/21/85 1919.3 

/* BEGIN dn355_data.incl.pll */ 

/* Date Last Modified and Reason 

Created 07/25/74 by R. B. Snyder for new ttydim. 

Modified 06/23/77 by J. Stern to add channel_work_reqd and cwork_count 
Modified 08/14/78 by Robert Coren to remove devx_tab and invent PCBs 
Modified 79 May 14 by Art Beattie to add fnp_mem_slEe 
Modified December 1979 by Robert Coren to add FNP queue lock 
Modified January 1980 by Larry Johnson to increase max number of FNPs to 8 
Modified 02/12/80 by Robert Coren to add dcw_list_array__ptr 
Modified 03/06/80 by Robert Coren to add some metering info 
Modified 12/10/80 by Robert Coren to add get_meters_waltlng flag 
Modified 83-12-16 BIM to use a chanid instead of lom/channel fb's. 
Modified 1984-07-26 BIM for paged iom. 
*/ 

/* LOCKING RULES: A fnp is locked by its I.CTE unless its LCTE is uninitialized. 
In that case, the configuration lock must be held. 

if tty_lock$lock__lcte returns io_no_permission, then the caller must 
lock$lock_fast the configuration lock and retry the LCTE lock. If 
the lcte is now initialized, too bad. Otherwise, the config lock protects. 

Configuration locking is interesting to init_multlplexer and 
all of fnp t&d and reconfiguration. The guts of the multiplexer 
pay no attention to it. Thus, if the LCTE can be locked, it MUST be 
locked before changing the io_manager_as signed flag. */ 

/* format: style4,delnl, insnl, A ifthendo */ 

del max_no_355s fixed bin int static lnit (8) options (constant) i 

/* max no of 355s we can handle (arbitrary) */ 
del dn355_data$ external fixed bin; 

del infop pointer i 
del fnpp ptrj 

del 1 datanet_info aligned based (infop), 
2 conf lguration_lock aligned, 
3 pid bit (36) aligned, 
3 event bit (36) aligned, 
3 flags aligned, 

4 notify av bit (1) unaligned, 
4 pad bit (35) aligned, 
2 no_of_355s fixed bin, /* no. of FNP's */ 

2 trace bit (1) aligned, /* watch events on console */ 

2 debug_stop bit (1) aligned, /* crash on errors */ 

2 pad (2) bit (36) aligned, /* to get alignment for dump reading */ 

2 per_datanet (max_no_355s) aligned like fnp_info: /* data per datanet */ 
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del 1 fnp_ln£o aligned based (fnpp), 
2 mbxpc pointer, 

2 pcb_array_ptr pointer, 

2 dcw_list_array_ptr pointer, 

2 no_of_channels fixed bin, 

2 fnp_ld, 

3 fnp_tag char (1) unaligned, 

3 fnp_number fixed bin (9) unsigned unaligned, 

3 padc bit (18) unaligned, 

io_chanid char <8) aligned, 

io_manager_chx fixed bin (35), 

lsla_ldx (0:5) fixed bin aligned, 

hsla_idx (0:2) fixed bin aligned, 

count fixed bin, 

cur ptr fixed bin, 

lastptr fixed bin, 

bleft_355 fixed bin, 

flags, 

3 work reqd bit (1) unaligned, 

3 bootloading bit (1) unaligned, 

3 running bit (1) unaligned, 

3 wired bit (1) unaligned, 

3 dump_patch_in_progress bit (1) unaligned, 

3 level 3 pending bit (1) unaligned, 

3 level_7_pending bit (1) unaligned, 

3 dump_patch_disabled bit (1) unaligned, 

3 t_and_d_in_progress bit (1) unaligned, 

3 t_and_d_lev_3_occurred bit (1) unaligned, 

3 t_and_d_lev_7_occurred bit (1) unaligned, 

3 t_and_d_notlfy_requested bit (1) unaligned, 

3 t_and_d_as signed bit (1) unaligned, 

3 get_meters_waiting bit (1) unaligned, 

3 padb bit (22) unaligned, 

2 lcte_ptr ptr, 

2 astep ptr, 

2 boot_ev_chan fixed bin (71), 

2 boot_process_ld bit (36), 

2 version char (4), 

2 f np_mem_s iae fixed bin (18) unsigned, 

2 queue_lock bit (36) aligned, 

2 dump_patch_lock bit (36), 

2 q_entrles_imade fixed bin (35), 

2 input_reject_count fixed bin, 

2 processed_from_q fixed bin (35), 

2 fnp_channel_locked fixed bin (35), 

2 inputdata transactions fixed bin (35), 

2 output_data_transactions fixed bin (35), 

2 lnput_control_transactions fixed bin (35), 

2 output_control_transactions fixed bin (35), 

2 cumulative mbxlnuse fixed bin (35), 

2 max_mbx_ln__use fixed bin, 

2 mbx_ln_use__updated fixed bin (35), 

2 mbx_unavailable fixed bin (35), 

2 free_size fixed bin (35), 

2 free_count fixed bin, 



/* structure for each FNP */ 

*< pointer to mailbox NULL if not in conflg */ 

* pointer to array of physical channel blocks */ 

* pointer to array of space reserved for output DCW lists */ 

* number of channels on this FNP */ 

* letter Identifying FNP */ 

* sequence number of FNP */ 



* devx for DIA on iom */ 

* index into PCB array for lsla lines */ 

* index into PCB array for hsla lines */ 

* number of items in delay queue */ 

* offset in tty_buf of next delay queue element */ 

* offset in tty_buf of last delay queue element */ 

* number of free buffers In this 355 */ 

* mailbox messages queued up */ 

* currently being bootloaded */ 

* this FNP is running */ 

* bootload buffer is wired */ 

* a dump or patch order is in progress */ 

* level 3 Interrupt pending */ 

* level 7 interrupt pending */ 

* dump & patch orders disabled because of timeout */ 

* T & D using FNP */ 

* A level 3 occurred */ 



* AS has given fnp to process */ 

* waiting for meter copy to complete */ 

* pointer to this FNP's LCI entry */ 

* pointer to aste of wired bootload buffer */ 

* event channel over which to signal bootload completion */ 

* process that initiated bootload */ 

* version id of core image */ 

* memory size of this FNP In 18-blt words */ 

* lock for interrupt queue */ 

* lock for fnp_dump or _patch operation */ 

* count of delay queue entries made */ 

* number of times input rejected */ 

* number of interrupts processed from queue */ 

* number of times dn355 found per-FNP lock locked */ 

* number of mailbox transactions for input */ 

* number of mailbox transactions for output */ 

* number of mailbox transactions for inbound control info */ 

* number of mailbox transactions for outbound control info */ 

* cumulative count of number of outbound mailboxes in use */ 

* maximum number of mailboxes in use at any given time */ 

* number of increments to cumulative_mbx_in_use */ 

* number of times had to queue mailbox transaction because none available */ 

* cumulative amount of bleft_355 */ 

* number of adds to above */ 
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fnp_space_restricted_output fixed bin (35), 

tandd_pcbx fixed bin, 

n_pages_wired fixed bin, 

config_flags aligned, 

3 available bit (1) unaligned, 

3 io_manager_assigned bit (1) unaligned, 

3 pad bit (34) aligned, 

ptx fixed bin, 

ptp pointer unaligned; 



/'• number of times available FNP space restricted amount of output sent */ 
/* index of PCB for COLTS channel */ 
/* pages wired for loading */ 

/* reconfig says "yes" */ 

/* We have channel assigned to us */ 

/* page table index, used only at bootload */ 
/* page table for this FNP */ 



/**** The following named constants are used to lay out the 
loin page tables . Each FNP has to have its own page 
table because there is not enough room to have eight different 
bootload images of 32 K and > 64 K of tty_buf 

THE MAX TTY BUF LENGTH IS 192 K words. We could have another 16 K 
easily, and then after that it would get hard. */ 



/**** The layout 

Page I/O address Memory address 



Comments 




1 
2 
3 

4 

35 

36 

63 
64 

127 
255 





2000 

4000 

6000 

10000 

110000 
112000 

160000 
200000 

260000 



xxxxxx 


2000 


4000 


6000 


as needed 


as needed 


xxxxxx 


as needed 


as needed 



invalid PTW 

write-enabled (mailbox) 
write-enabled (mailbox) 
write-enabled (mailbox) 
bootload image segment page 

bootload image segment page 31 
invalid PTW 

invalid PTW 
tty_buf page 

tty_bu£ page 63 
tty_buf page 191 



/**** He assume that the page table starts at all zeros. */ 

declare FIRST_BOOTLOAD_PAGEX fixed bin init (4) int static options (constant) i 
declare FIRST_TTlf_BUF_PAGEX fixed bin init (64) int static options (constant) i 

/* End include file dn355_data.incl.pll */ 
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segment in: 
entry modified: 



>Xdd> include 
06/21/85 1917.0 



contents modified: 11/08/82 1005.8 



/* BEGIN INCLUDE FILE 



let. incl.pll */ 



/* Created by J. Stern 7/26/78 */ 

/* Metering information added by C. Hornig, March 1980. */ 

/* Unwired saved meters added by Robert Cor en, December 1980 */ 



del lctp ptrj 

del lctep ptri 

del lct_size fixed bin; 

del 1 let aligned based (lctp), 
2 max_no_lctes fixed bin, 
2 cur_no_lctes fixed bin, 
2 lcnt_ptr ptr, 
2 queue_lock bit (36), 
2 pad (11) fixed bin, 
2 lcte_array (lct_size refer (lct.max_no_lctes)) like J.c 



del 1 lcte aligned based (lctep), 
2 lock bit (36), 
2 data_base_ptr ptr unal, 
2 channel_type fixed bin (8) unal, 
2 flags unal, 

3 entry__in_use bit (1) unal, 

3 Initialized bit (1) unal, 

3 notify_reqd bit (1) unal, 

3 locked_for_lnterrupt bit (1) unal, 

3 space_needed bit (1) unal, 

3 speeial_lock bit (1) unal, 

3 trace_force bit (1) unal, 

3 trace bit (1) unal, 

3 unused bit (1) unal, 
2 physlcal_channel_devx fixed bin (17) unal, 
2 major_channel_info, 

3 major_channel_devx fixed bin unal, 

3 subchannel fixed bin (17) unal, 
2 queue_entries, 

3 queue_head bit (18) unal, 

3 queue_tail bit (18) unal, 
2 word_counts, 

3 inputwords fixed bin (17) unal, 

3 output_words fixed bin (17) unal, 



* ptr to logical channel table */ 

* ptr to logical channel table entry */ 

* size of lcte_array when allocated */ 

* logical channel table */ 

* maximum number of let entries */ 

* current number of let entries used */ 

* ptr to logical channel name table */ 

* lock used to serialize queueing operations */ 

a j /* let entries */ 



* logical channel table entry */ 

* channel lock */ 

* ptr to channel data base */ 

* identifies channel manager program */ 



ON 
ON 



if this entry in use */ 

if this channel initialized 



'/ 



* ON if must notify vhen unlocking this channel */ 

* ON if lock set by interrupt handler */ 

* ON If this channel needs buffer space */ 

* ON if lock is managed by multiplexer *l 

* ON to trace based on next bit only */ 

* OFF to XOR next bit with ttybuf .default_traclng */ 

* ON to trace this channel */ 



* devx of physical chan from which logical chan is derived */ 

* major channel device index */ 

* subchannel id (or data ptr) wrt major channel */ 

* ptr to first queue entry for this channel */ 

* ptr to last queue entry for this channel */ 

* number of input words charged to this channel */ 

* number of output words charged to this channel */ 



2 meters, 

3 ln_bytes fixed bin (35), 
3 out_bytes fixed bin (35), 
3 in, 

4 calls fixed bin (35), 



* . inel 



let. Incl.pll 



Page 



4 interrupts fixed bin (35), 
4 calltime fixed bin (71), 
4 interrupt__t ime fixed bin (71), 
3 out like Lcte .meters . in, 
3 control like lcte. meters. in, 
2 saved_meters_ptr ptr, 

2 timer_offset bit (18) aligned, 

2 pad (3) fixed bin (35) i 



/* pointer to unwired copy of meters saved at last dialup */ 
/* Head of list of timers for this channel */ 



del lentp ptri 

del 1 lent aligned based (lentp), 

2 names ( lot . maxno lctes) char (32) unalt 

del 1 saved_meters aligned based like lcte. meters) 



/* ptr to logical channel name table */ 

/* logical channel name table */ 
/* channel names */ 

/* meters saved at dialup, allocated in tty_area */ 



/* END INCLUDE FILE ... lct.incl.pll */ 



*.incl 



let . incl .pll 



Page 



pcb. lncl.pll 



segment in : 
entry modified: 



>ldd> include 
06/21/85 1915.3 



contents modified; 07/08/81 10*5.8 



/* 

/* 
/* 
/* 
/* 



BEGIN INCLUDE FILE 



pcb.incl.pll */ 



Created 08/14/78 by Robert S. Coren */ 

Modified 02/19/80 by Robert S. Coren to add read_first & read_last 
Modified 12/10/80 by Robert S. Coren to add metering stuff */ 
Modified May 1981 by Robert S. Coren to add tandd_attached flag */ 



/* Describes physical channel blocks for FNP channels */ 

del n pebs fixed bini 
del pebp ptri 

del 1 pebarray (n_pcbs) based aligned like pcbi 

del 1 pcb aligned based (pebp), 
2 channel_desc unaligned, 

3 devx fixed bin (17), 

3 subchan fixed bin (7) unaligned, 

3 line_number unal, 

4 is_hsla bit (1) unaligned, 
4 la_no bit (3) unaligned, 
4 slot_no bit (6) unaligned, 
2 wrlte_first fixed bin (17) unaligned, 
2 wrlte_last fixed bin (17) unaligned, 
2 baud_rate fixed bin (17) unaligned, 
2 line type fixed bin (17) unaligned, 
2 max_buf_size fixed bin (17) unaligned, 
2 wrlte_cnt fixed bin (17) unaligned, 
2 flags unaligned, 

3 listen bit (1), 

3 dialed bit (1), 

3 send_output bit (1), 

3 high_speed bit (1), 

3 sync_line bit (1), 

3 end_frame bit (1), 

3 hndlquit bit (1), 

3 breakall_enabled bit (1), 

3 output_mbx_pending bit (1), 

3 copied_meters_ready bit (1), 

3 get_meters_walting bit (1), 

3 tandd_attached bit (1), 

3 padb bit (24), 
2 read first fixed bin (18) unsigned unaligned, 
2 read last fixed bin (18) unsigned unaligned, 
2 saved_meters_ptr pointer unaligned, 
2 copled_meters_offset fixed bin (18) unsigned! 

/* END INCLUDE FILE ... pcb.incl.pll */ 



/* physical channel block declaration */ 

* index of LCT entry */ 

* logical subchannel/lsla slot # correspondence */ 

* regular line number */ 

* on if hsla, off if lsla */ 

* line adapter (high or low speed) number */ 

* physical slot or subchannel number */ 

* offset of first buffer in output chain */ 

* offset of last buffer in output chain */ 

* baud rate of channel */ 

* line type */ 

* largest buffer to be allocated for output */ 

* number of characters in write chain */ 

* channel is ready for dialup */ 

* channel is dialed up or connected */ 

* channel is ready for output */ 

* needs large send_out threshold */ 

* synchronous channel */ 

* channel is waiting for formfeed */ 

* channel in hndlquit mode */ 

* breakall mode allowed for this channel */ 

* A wtx mbx has been sent, but not relinquished */ 

* copy_meters operation has completed */ 

* waiting for get_meters operation to complete */ 

* this channel Is In use by T & D */ 

* head of read chain (while reading from FNP) */ 

* tall of read chain (likewise) */ 

* pointer to (unwired) copy of meters at last dialup */ 

* offset in tty_buf of buffer meters copied to */ 



* . incl 



pcb. lncl.pll 



Page 



tcb.. incl.pll 



segment in: 
entry modified: 



>idd> include 
06/21/85 1915.2 



contents modified: 06/18/81 0900.8 



/* BEGIN INCLUDE FILE 



tcb. incl.pll */ 



*/ 



Date Last Modified and Reason 

Created 04/19/77 by J. Stern (from part of tty. incl.pll) 

Modified 2/6/78 by Robert Coren to add input_msg_size 

Modified 4/18/78 by Robert Coren to add framing chars 

Modified 8/31/78 by J. Nicholls to add scroll mode 

Extracted 9/12/78 by J. Stern from tty_data. incl.pll 

Modified Oct. 1979 by Robert Coren to expand to 36 possible modes 

Modified 1/21/80 by Robert Coren to add no_outp, oddp, & elght_bit modes 

Modified 10/08/80 by Robert Coren to add meters for tty_read & tty_write 

Modified: 10 November 1980 by G. Palter to add can type and explicit padding 

Modified 12/04/80 by Robert Coren to add saved copy of meters 

Modified 2/24/81 by Robert Coren to add time spent in tty_read and _write 

Modified April 1981 by Robert Coren to add time last dialed up 



del tcbp ptri 



del 1 tcb based (tcbp) aligned, 

2 terminal_type char (32) unaligned, 

2 tables, 

3 input_mvtrp bit (18) unaligned, 
3 output_mvtrp bit (18) unaligned, 
3 input_tctrp bit (18) unaligned, 
3 output_tctrp bit (18) unaligned, 
3 speciolrp bit (18) unaligned, 
3 delayrp bit (18) unaligned, 

2 def ault_tables , 

3 df_input_mvtrp bit (18) unaligned, 
3 df_output_mvtrp bit (18) unaligned, 
3 df_input_tctrp bit (18) unaligned, 
3 df_output_tctrp bit (18) unaligned, 
3 df_specialrp bit (18) unaligned, 
3 df_delayrp bit (18) unaligned, 

2 special_input_chars unaligned, 
3 erase char (1) unaligned, 
3 kill char (1) unaligned, 

2 old_type fixed bin (17) unaligned, 

2 modes unaligned, 

3 edited bit (1) unaligned, 
3 tabm bit (1) unaligned, 
3 canm bit (1) unaligned, 

3 escm bit (1) unaligned, 
3 erklm bit (1) unaligned, 
3 rawim bit (1) unaligned, 



* declaration of per terminal control block */ 

* terminal type name */ 

* rel pointer to current input mvt table */ 

* rel pointer to current output mvt table */ 

* rel pointer to current input tct table */ 

* rel pointer to current output tct table */ 

* rel pointer to current special chars table */ 

* rel pointer to current delay table */ 

* rel pointer to default input mvt table */ 

* rel pointer to default output mvt table */ 

* rel pointer to default input tct table */ 

* rel pointer to default output tct table */ 

* rel pointer to default special chars table */ 

* rel pointer to default delay table */ 

* erase character */ 

* kill character */ 

* old terminal type number */ 

* modes set by order call */ 

* edited output mode */ 

'* insert output tabs mode */ 

* do canonical form conversion */ 

* do input escape conversions */ 

* do erase kill processing */ 

* don't convert input */ 
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3 rawom bit (1) unaligned, 
3 redm bit (1) unaligned, 
3 vertsp bit (1) unaligned, 

3 echo cr bit (1) unaligned, 
3 echo If bit (1) unaligned, 
3 eeho_tab bit (1) unaligned, 

3 hndlquit bit (1) unaligned, 
3 full_duplex bit (1) unaligned, 
3 echoplex bit (1) unaligned, 

3 upper_case bit (1) unaligned, 
3 replay bit (1) unaligned, 
3 polite bit (1) unaligned, 

3 control bit (1) unaligned, 
3 blk_xfer bit. (1) unaligned, 
3 breakall bit (1) unaligned, 

3 scroll bit (1) unaligned, 
3 prefixni bit (1) unaligned, 
3 wake_tbl bit (1) unaligned, 

3 iflow bit (1) unaligned, 
3 of low bit (1) unaligned, 
3 no_outp bit (1) unaligned, 

3 eight_bit bit (1) unaligned, 
3 odd_parlty bit (1) unaligned, 

3 modes pad bit (7) unaligned, 

2 Id char (4) unaligned, 

2 colmax fixed bin (8) unaligned, 
2 linemax fixed bin (8) unaligned, 
2 wrt_lchar fixed bin (17) unaligned, 

2 input msg size fixed bin, 
2 framlng_chars unaligned, 

3 frame_begin char (1) unaligned, 

3 frame end char (1) unaligned, 
2 max_output_block fixed bin (18) unsigned unaligned, 

2 input_suspend seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char (3), 
2 input_resume_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char ( 3 ) , 

2 output_suspend_etb_seq unaligned, 

3 count fixed bin (9) unsigned, 

3 chars char ( 3 ) , 
2 output_resume__ack_seq unaligned, 



/* don't convert output */ 
/* has red-shift function */ 
/* send real ff's and vt's if on, else escape them */ 

/* echo carriage returns */ 
/* echo Una feeds */ 
/* echo tabs */ 

/* cr's on quit */ 

/* xmit and receive simultaneously */ 

/* echo input characters on terminal */ 

/* map lower-case output into upper-case */ 

/* replay interrupted input */ 

/* output must start at left margin */ 

/* accept control characters */ 

/* block transfer or "frame" mode */ 

/*> break on all characters */ 

/* scroll mode for crt terminals */ 

/* prefix output iwth nl when input interrupted */ 

/* input wakeups determined by wakeup table */ 

/* input flow control */ 

/* output flow control */ 

/* don't generate output parity */ 

/* don't strip input parity */ 

/* generate odd parity (if any) */ 



/* terminal id */ 

/* current maximum number of columns */ 

/ft current maximum number of lines/frame */ 

I* char within last write block */ 

/* maximum Input message size in chars */ 

/* frame-begin character */ 

/* frame-end character */ 

/* maximum size of output block in block_acknowledge */ 



/ft sequence for input suspension */ 



/* likewise for input resumption */ 



/* sequence for output suspension or end_of_block */ 



/* likewise for resumption or ack */ 
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3 count fixed bin (9) unsigned, 
3 chars char (3), 



2 flags unaligned, 

3 breakall enabled bit (1) unaligned, 
3 dont_eount_next bit (1) unaligned, 
3 keyboard locking bit (1) unaligned, 
3 no_printer_off bit (1) unaligned, 
3 break_char_pendlng bit (1) unaligned, 
3 uproc_attached bit (1) unaligned, 
3 biock_acknowledge bit (1) unaligned, 
3 flags_pad bit (27) unaligned, 

2 actshift bit (2) unaligned, 

2 cumulative_meters , 

3 read_calls fixed bin (35) , 

3 wrlte_calls fixed bin (35), 

3 read_chars fixed bin (35), 

3 wrlte_chars fixed bin (35), 

3 read_time fixed bin (71), 

3 write_tlme fixed bin (71), 
2 saved_meters like tcb.cumulative_meters, 

2 can_type fixed binary (9) unaligned unsigned, 
2 padl bit (27) unaligned, 
2 time_dlaled fixed bin (71); 



/* tty dim flag bits */ 

/* channel is permitted to use breakall mode ''</ 

/* next output character is escaped */ 

/* OH if doing keybd locking for ASCII line type */ 

/* reject prlnter_off /printer_on orders */ 

/* break character Is in preconverted buffer */ 

/* user process has attached device */ 

/* block acknowledgement output protocol */ 



/* tty shift, 00 none, 01 lower, 10 upper, 11 unknown */ 

/* continuously running meters */ 
/* number of calls to tty_read */ 
/* number of calls to tty_write */ 
/* after conversion */ 
/* before conversion */ 
/* total time spent in ttyread */ 
/* total time spent in tty_write */ 
/* meters saved at last dialup */ 

/* type of canonical izatlon to use on this channel */ 

/* to word boundary */ 

/* clock time of last copy_meters order */ 



/* END INCLUDE FILE 



tcb.incl.pll */ 
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tty_buf . incl.pll 



segment in: 
entry modified: 



>ldd> include 
06/21/85 1919.6 



contents modified: 01/06/85 1422.1 



I* BEGIN INCLUDE FILE 



tty_buf. incl.pll */ 



/* Date Last Modified and Reason 

Created 04/19/77 by J. Stern (from part of tty. incl.pll) 

Modified January 1978 by Robert Coren and Larry Johnson for variable-size buffers 

Modified 2/6/78 by Robert Coren to make circular_queue size settable 

Modified Aug 78 by J. Nicholls to move the buffer block format to a file of its own 

and wtcb to its own plus other modification for ring multiplexing, tty_buffer_block. incl.pll 

Modified 7/17/79 by B. Greenberg for echo negotiation meters. 

Modified November 1979 by C. Hornig for MCS tracing. 

Modified December 1979 by Robert Coren to add FNP channel lock meter 

Modified February 1980 by Robert Coren to remove all references to circular buffer 

Modified March 1980 by Robert Coren to reorganize metering information 

Modified December 1980 by Robert Coren to add FNP-speci.fic events 

Modified 24 March 1982, W. Olln Sibert, to add mcs_timer support, recoverable_error_severity 

Modified November 1984 by Robert Coren to add tty_area lock 
*/ 

del ttybp ptr, 

tty_buf$ ext static, /* tty buffer segment */ 

tty_ev fixed bin int static options (constant) init (57), /* event used for wait and notify */ 

abs_buf_litnit fixed bin (18) static options (constant) init (64), /* minimum number of words we will leave free */ 

input_bpart fixed bin (18) static options (constant) init (2), /* fraction of bleft we will allow for input */ 

output_bpart fixed bin (18) static options (constant) init (4)i /* fraction of bleft we will allow for output */ 

del qblock_slze fixed bin int static options (constant) init (16); /* size in words of a delay queue block */ 

del bsizec fixed bin int static options (constant) init (60) i /* number of characters in smallest buffer */ 

del buf_per_second fixed bin int static options (constant) init (10) ( /* for figuring out max. buffer size based on speed */ 

del FNP_DUMP_PA1CH_EVENT fixed bin int static options (constant) init (58) i 

del FNP_METER_EVENT fixed bin int static options (constant) init (59) i 

del TTY_AREA_LOCK_EVENT bit (36) aligned int static options (constant) init ("74"b3)i 



del 1 tty_buf aligned based (ttybp), 
2 slock bit (36), 
2 absorig fixed bin (24), 
2 borlg bit (18), 
2 bleft fixed bin (18), 
2 free bit (18), 

2 fnp_config_flags (8) bit (1) unal, 
2 padbl bit (28) unaligned, 
2 lct_ptr ptr, 

2 nrawread fixed bin (35), 
2 nrawwrlte fixed bin (35), 
2 ninchars fixed bin (35), 
2 noutchars fixed bin (35), 
2 readblocked fixed bin (35), 
2 nblocked fixed bin (35), 



* declaration of tty buffer seg */ 
ft per system look */ 

* abs address of this seg */ 

ft Index of start of buffer area */ 
ft words left in pool */ 

* pointer to start of free pool */ 

* flag(i) ON if fnp(i) configured */ 

* pointer to logical channel table */ 

* number of raw chars input, total */ 
ft number of raw characters output ft/ 

* total input chars after conversion */ 

* total output chars before conversion */ 
ft number of times go input blocked */ 

* number of times process output blocked */ 
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2 minbuf fixed bin (18), 
2 totbuf fixed bin (35), 

2 preconverted fixed bin (35), 

2 lnput_restart fixed bin, 

2 output restart fixed bin, 

2 output_buffer_overflow fixed bin, 

2 read_time fixed bin (71), 

2 write_time fixed bin (71), 

2 read_calls fixed bin (35), 

2 write_calls fixed bin (35), 

2 bfx fixed bin, 

2 nquits fixed bin (35), 

2 space_needed_data, 

3 spaceneeded bit (1) unal, 

3 space_needed_calls fixed bin (34) unal, 
2 space_look_count fixed bin (35), 
2 space_lock_walt_count fixed bin (35), 
2 space_lock_waLt_t.ime fixed bin (35), 

2 alloccalls fixed bin (35), 

2 free_calls fixed bin (35), 

2 alloc_time fixed bin (35), 

2 free_tlme fixed bin (35), 

2 total_alloc_steps fixed bin (35), 

2 alloc _f allures fixed bin (35), 

2 cumulative_input_space fixed bin (71), 

2 cumulative_output_space fixed bin (71), 
2 cumulative_control_space fixed bin (71), 
2 input_spaoe_updates fixed bin (35), 
2 output_space_updates fixed bin (35), 
2 control space updates fixed bin (35), 
2 minimum_free_space fixed bin (18), 

2 current_input space fixed bin (18) , 

2 current_output_3pace fixed bin (18), 

2 current_control_space fixed bin (18), 

2 tty_lock .calls fixed bin (35), 

2 found_chanuel locked fixed bin (35), 

2 maxwalttlme fixed bin (35), 

2 total_walt_tlme fixed bin (71), 

2 echo_neg_time fixed bin (71), 

2 echo_neg_interrupts fixed bin (35), 

2 echo_neg_rO_chars fixed bin (35), 

2 echo_neg_mux_chars fixed bin (35), 

2 echo_neg_sndopt_restarts fixed bin (35), 

2 echo_neg_mux_nonecho fixed bin (35), 

2 echo_neg_entries fixed bin (35), 

2 echo_neg_mux_inhibit bit (1) aligned, 
2 n_queued_interrupts fixed bin (35), 
2 trace unaligned, 
3 flags, 



/* min output buffer size */ 
I* divide by nblocked to get ave buffer size */ 



* number of converted chars held in tty_buf */ 

* number of times tty_read had to start over */ 

* number of times tty_write has had to start over */ 

* number of times tty_write has run out of buffers */ 

* total time spent in tty_read */ 

* total time spent in tty_write */ 



* number of calls to tty_read */ 

* number of calls to tty_write */ 

* used in calls to iobm */ 

* number of quits */ 



»/ 



* space_needed bit on in at least 1 lcte 

* meter of uses of this facility */ 

* count of times ttybuf. slock locked */ 

* count of times necessary to loop to lock it */ 

* total time looped trying to lock It */ 



* total number of allocations performed in tty_buf */ 

* total number of freeings in tty_buf */ 

* time spent masked in tty_space_man$get entries */ 

* time spent masked in tty_space_man$free entries */ 

* number of steps thru free chain while doing above */ 

* number of unsuccessful attempts to allocate space */ 

* cumulative amount of space allocated for input */ 

* cumulative amount of space allocated for output */ 

* cumulative amount of space allocated by tty_space_man$get_spaee */ 

* number of increments to cumulative_input_space */ 

* number of increments to cumulative_output_space */ 

* number of increments to cumulative_control_space */ 

* smallest amount of free space ever available */ 

* amount of space currently allocated for input */ 

* amount of space currently allocated for output */ 

* amount of space currently allocated by get_space */ 

* number of calls to tty_lock$lock entries */ 

* number of times tty_lock found channel already locked */ 

* longest time waited for any channel lock */ 

* total amount of time spent waiting for channel locks */ 

* cumulative time spent doing echo negotiation */ 

* Echo-negotiated shipments */ 

* Chars echoed by ring */ 

* Chars echoed by mux */ 

* Echo remits */ 

* Entries into negotiate */ 

* For testing */ 

* number of interrupts queued by tty_lock */ 

* tracing information */ 
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4 enable bit, 

4 default_mode bit, 

4 read bit, 

4 write bit, 

4 data bit, 

4 control bit, 

4 modes bit, 

4 interrupt bit, 

4 init bit, 

4 start bit, 

4 shutdown bit, 

4 space_man bit, 

4 pad_£lags bit <6), 

3 data_of£set bit (18), 

2 recoverable_error_severity fixed bin, 

2 timer_lock bit (36) aligned, 

2 next_tlmer_o£i : set bit (18) aligned, 

2 timer_count fixed bin, 

2 ticner_process bit (36) aligned, 

2 timer_ev_chn fixed bin (71), 

2 timer_lock_wait_time fixed bin (71), 

2 tlraer_lock_count fixed bin (35), 

2 timer_lock_wait_count fixed bin (35), 

2 timer_call_time fixed bin (71), 

2 timer_polling_time fixed bin (71), 
2 tlmer_set_calls fixed bin (35), 
2 tlmer_reset_calls fixed bin (35), 

2 timer_change_calls fixed bin (35), 

2 tlmer_poll_calls fixed bin (35), 

2 timer_error_calls fixed bin (35), 

2 timer_dupiieate_pollings fixed bin (35), 

2 tty_area_lock like hc_fast_iock, 

2 pad2 (13) fixed bin (35), 

2 £ree_spaoe fixed bin) 

/(include hc_fast_locks 

/* END INCLUDE FILE ... tty_buf.incl.pll */ 



/* global tracing control */ 

* whether to trace channels by default */ 

* read */ 

* write */ 

* buffers on reads and writes */ 

* control, prlv_control, and hpriv_controi */ 

* (get set check)_modes */ 

* interrupt, interrupt_later */ 

* inlt_multiplexer, terminate_multlplexer */ 

* start, stop */ 

* shutdown */ 

* tty_space_man$* */ 

* offset of tracing data */ 

* Syserr severity for recoverable MCS errors */ 

* Lock owned by mcs_timer */ 

* Offset of next timer to come due */ 

* Number of timers outstanding */ 

* Who is doing timers? */ 

* How get get him */ 

* CPU time spent spinning on timer lock */ . 

* Number of times timer lock locked */ 

* Number of times imer lock waited on */ 

* CPU time spent in call side timer operations */ 

* CPU time spent polling (including channel_manager) */ 

* Number of calls to mcs_timer$set, set_wired */ 

* Number of calls to mcs_timer$reset, reset_wired */ 

* Number of calls to mcs_timer$change, change_wired */ 

* Number of calls to mcs_tlmer$poll */ 

* Number of mcs timer calls ending with recoverable errors */ 

* Number of timer polling found in progress on other CPU */ 



/* to prevent contention in allocating/freeing in tty_area */ 



/* start of free space region *l 
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tty_buffer_block. incl .pll 



segment in: >ldd> include contents modified; 06/18/81 0900.8 
entry modified: 06/21/85 1915.2 



/* BEGIN INCLUDE FILE ... tty_buffer_block. incl. pll */ 



/* 



Separated from tty_buf. incl. pll aug 78 by J. Nicholls 

Modified May 1979 by Larry Johnson to add max_buffer_tally array and to use unsigned variables. 



*/ 

del blockp ptri 

del free blockp ptrj 



/* pointer which block entry is based on */ 
/* pointer to head of free space chain */ 



del 1 free_blook aligned based (free_blockp) , 
2 next bit (18) , 
2 size fixed bint 



/* format of start of free block */ 

/* foward pointer to next free block */ 

/* number of words in this block */ 



del 1 buffer based (blockp) aligned, 
2 next fixed bin (18) unal uns, 
2 flags unaligned, 

3 end_of_page bit (1) unaligned, 
3 converted bit (1) unaligned, 
3 break bit (1) unaligned, 
3 mark bit (1) unaligned, 
3 pad bit (2) unaligned, 
2 size_code fixed bin (3) unal uns, 
2 tally fixed bin (9) unal uns, 
2 chars (0:59) char (1) unaligned) 



/* buffer definition */ 
/* addr of next buffer */ 

/* buffer contains end of page */ 

/* buffer contains converted input */ 

/* buffer contains break character */ 

/* buffer contains first character after "mark" */ 

/* (nwords/16) - 1 */ 

/* number of characters in buffer */ 

/* room for 60 data characters */ 



/* the following array, if indexed by buffer. sizecode will give maximum number of characters permitted in that buffer */ 
del max_buffer_tally (0:7) fixed bin int static options (constant) lnit (60, 124, 188, 252, 316, 380, 444, 508) i 
/* END INCLUDE FILE ... tty_buffer_block. incl .pll */ 
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wtcb. incl.pll 



segment in: 
entry modified: 



>ldd> include 
06/21/85 1920.0 



contents modified: 01/30/85 1523.9 



/* BEGIN INCLUDE FILE 



wtcb. incl.pll */ 



Moved from tt.y_buf. incl.pll Aug 78 by J. Nicholls plus changes for ring demultiplexing 
Error code added Nov. 1982 by Robert Coren 

Modified December 1984 by Robert Coren to invent "more_flags" structure and 
its first flag, line_status disabled 



del wtcbp ptn 

del 1 wtcb based (wtcbp) aligned, 

2 hevent fixed bin (71) aligned, 
2 event fixed bin (71) aligned, 

2 llne_status bit (72) aligned, 

2 tcb_ptr ptr unal, 
2 padl fixed bin (35), 

2 hproc bit (36) aligned, 
2 uproc bit (36) aligned, 

2 baud_rate fixed bin (18) unal uns, 
2 line_type fixed bin (18) unal uns, 

2 flags unaligned, 

3 listen bit (1) unaligned, 
3 dialed bit (1) unaligned, 
3 send_output bit (1) unaligned, 

3 qenable bit (1) unaligned, 

3 qflag bit (1) unaligned, 

3 end_frame bit (1) unaligned, 

3 notify_reqd bit (1) unaligned, 
3 work_reqd bit (1) unaligned, 
3 dialing bit (1) unaligned, 

3 dial_status_ valid bit (1) unaligned, 
3 input_ava liable bit (1) unaligned, 
3 tcb_initialized bit (1) unaligned, 

3 wflag bit (1) unaligned, 
3 rflag bit (1) unaligned, 
3 wru bit (1) unaligned, 

3 hndlquit bit (1) unaligned, 

3 count_lines bit (1) unaligned, 

3 line_status_present bit (1) unaligned, 



/* pointer to head of wtcb */ 

* wired terminal control block */ 

* event channel for hangup/dialup signal */ 

* users event channel, for uproc */ 

* actual line status sent by fnp */ 

* pointer to tcb */ 

* formerly time dialedup */ 

* boss processid */ 

* tty user processid */ 

* baud rate of this line */ 

* line type for line protocol */ 



* If on, listen for dialups */ 

* if on, line is dialed up */ 

* on if DN355 requested more output */ 

* if on, signal quits */ 

* on after quit, causes writes to be ignored */ 

* write chain fills ards frame */ 

* if on, do notify after unlocking lock */ 

* if on, call dn355 before returning */ 

* if on, 355 is dialing a phone number */ 

* if on, dial_status_code is valid */ 

* input for this device is waiting in wired space */ 

* if on, tcb has been initialized */ 

* process blocked on output */ 

* process blocked on input */ 

* reading answerback */ 

* on if in hndlquit mode */ 

* on if tcb . 1 lnemax > */ 

* fnp has sent line status */ 



* . incl 



wtcb. incl .pll 



Page 



14 



3 sync_line bit (1) unaligned, 
3 breakall bit (1) unaligned, 
3 scroll bit (1) unaligned, 

3 negotiating_echo bit (1) unaligned, 

3 wake_tbl bit (1) unaligned, 

3 allow_wakeup bit (1) unaligned, 

3 receive_mode_device bit (1) unaligned, 
3 mark_set bit (1) unal, 
3 masked bit (1) unal, 

2 dial_status_code fixed bin (8) unaligned, 

2 fblock fixed bin (17) unaligned, 
2 lblock fixed bin (17) unaligned, 

2 fchar fixed bin (9) unsigned unaligned, 
2 a ct line fixed bin (9) unsigned unaligned, 
2 actcol fixed bin (9) unsigned unaligned, 
2 nramsgs fixed bin (9) unsigned unaligned, 

2 writefirst fixed bin (17) unaligned, 
2 wrlte_last fixed bin (17) unaligned, 
2 write_cnt fixed bin (17) unaligned, 
2 whltecol fixed bin (17) unaligned, 



max_buf_size fixed bin (9) unal uns, 

buf£er_pad fixed bin (9) unal uns, 

devx fixed bin (17) unaligned, 

echdp bit (18) unaligned, 

waketp bit (18) unaligned, 

prompt_len fixed bin (8) unaligned, 

prompt char (3) unaligned, 

line_delimiter char (1) unal, 

more_flags unaligned, 

3 llnestatus disabled bit (1) unaligned, 

3 pad bit (26) unal, 

error_code fixed bin (35), 

pad2 bit (36)i 



* channel is synchronous line type */ 

* channel is in breakall mode */ 

* channel is In scroll mode */ 

* ring zero to echo chars. */ 

* on If in wake_tbl mode */ 

* on to allow input wakeup in wake_tbl mode */ 

* device must be told to enter receive mode */ 

* write_with_mark call outstanding */ 

* channel masked by FNP */ 

* code returned by 355 after dialing a phone number */ 

* oldest road pointer, block */ 

* newest read block */ 

* first block char index */ 

* line number of current line */ 

* tty column position */ 

* current number of read-ahead msgs */ 

* first write block */ 

* last write block */ 

* count of chars in write chain */ 

* column position resulting from trailing white space */ 

* maximum-size buffer to be allocated for this channel */ 

* amount of pad to be left in output buffers */ 

* index into let of channel's entry */ 

* echo negotiation data ptr */ 

* wakeup table offset */ 

* number of chars in prompt string */ 

* text of prompt message */ 

* line delimiter for tty_read parse */ 

* in addition to flags (above) */ 

* "l"b -=> don't relay line_status interrupts */ 

/* error code returned by channeljnanager to tty_interrupt */ 



/* Ends on doubleword boundary *l 



I* END INCLUDE FILE 



wtcb.incl.pll */ 
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